hardness 1.0.0

package/packages/core/dist/sprint/scorer.js

@@ -0,0 +1,109 @@
+/**
+ * Computes the quality score (0-10) of a Sprint.
+ */
+export function scoreSprint(sprint) {
+    const totalFeatures = sprint.features.length;
+    if (totalFeatures === 0) {
+        return {
+            totalScore: 10,
+            breakdown: {
+                granularity: { score: 10, maxScore: 10, description: 'No features to evaluate' },
+                grepGates: { score: 10, maxScore: 10, description: 'No features to evaluate' },
+                smokeTests: { score: 10, maxScore: 10, description: 'No features to evaluate' },
+                criteriaAndHints: { score: 10, maxScore: 10, description: 'No features to evaluate' },
+                titleClarity: { score: 10, maxScore: 10, description: 'No features to evaluate' },
+            }
+        };
+    }
+    // 1. Granularity: target is 1-5 files per feature
+    let granularityScore = 10;
+    for (const feat of sprint.features) {
+        const fileCount = feat.files.length;
+        if (fileCount > 5) {
+            granularityScore -= (fileCount - 5) * 2; // -2 per extra file
+        }
+    }
+    granularityScore = Math.max(0, granularityScore);
+    // 2. Grep Gates: features should have at least one grepMustMatch or grepMustNotMatch
+    let grepGatesScore = 10;
+    let featuresWithoutGrep = 0;
+    for (const feat of sprint.features) {
+        const hasGrepMatch = feat.verification.grepMustMatch && feat.verification.grepMustMatch.length > 0;
+        const hasGrepNotMatch = feat.verification.grepMustNotMatch && feat.verification.grepMustNotMatch.length > 0;
+        if (!hasGrepMatch && !hasGrepNotMatch) {
+            featuresWithoutGrep++;
+        }
+    }
+    grepGatesScore -= (featuresWithoutGrep / totalFeatures) * 10;
+    grepGatesScore = Math.max(0, Math.round(grepGatesScore * 10) / 10);
+    // 3. Smoke Tests: bonus for having a smoke test (smoke.command)
+    let smokeTestsScore = 0;
+    let featuresWithSmoke = 0;
+    for (const feat of sprint.features) {
+        if (feat.verification.smoke && feat.verification.smoke.command) {
+            featuresWithSmoke++;
+        }
+    }
+    smokeTestsScore = (featuresWithSmoke / totalFeatures) * 10;
+    smokeTestsScore = Math.min(10, Math.round(smokeTestsScore * 10) / 10);
+    // 4. Criteria & Hints: AC >= 2, Hints >= 1
+    let critHintsScore = 10;
+    let invalidFeats = 0;
+    for (const feat of sprint.features) {
+        const acCount = feat.acceptanceCriteria.length;
+        const hintCount = feat.hints.length;
+        if (acCount < 2 || hintCount < 1) {
+            invalidFeats++;
+        }
+    }
+    critHintsScore -= (invalidFeats / totalFeatures) * 10;
+    critHintsScore = Math.max(0, Math.round(critHintsScore * 10) / 10);
+    // 5. Title Clarity: title should have >= 3 words
+    let titleClarityScore = 10;
+    let shortTitles = 0;
+    for (const feat of sprint.features) {
+        const wordCount = feat.title.trim().split(/\s+/).length;
+        if (wordCount < 3) {
+            shortTitles++;
+        }
+    }
+    titleClarityScore -= (shortTitles / totalFeatures) * 10;
+    titleClarityScore = Math.max(0, Math.round(titleClarityScore * 10) / 10);
+    // Weighted average
+    const totalScore = (granularityScore * 0.3 +
+        grepGatesScore * 0.3 +
+        smokeTestsScore * 0.1 +
+        critHintsScore * 0.2 +
+        titleClarityScore * 0.1);
+    return {
+        totalScore: Math.min(10, Math.round(totalScore * 10) / 10),
+        breakdown: {
+            granularity: {
+                score: granularityScore,
+                maxScore: 10,
+                description: granularityScore === 10 ? 'Excellent granularity' : 'Features with too many files'
+            },
+            grepGates: {
+                score: grepGatesScore,
+                maxScore: 10,
+                description: `${featuresWithoutGrep} of ${totalFeatures} features without grep gates`
+            },
+            smokeTests: {
+                score: smokeTestsScore,
+                maxScore: 10,
+                description: `${featuresWithSmoke} of ${totalFeatures} features with smoke test`
+            },
+            criteriaAndHints: {
+                score: critHintsScore,
+                maxScore: 10,
+                description: invalidFeats > 0 ? 'Missing AC or hints in some features' : 'All criteria and hints filled'
+            },
+            titleClarity: {
+                score: titleClarityScore,
+                maxScore: 10,
+                description: shortTitles > 0 ? 'Titles too short detected' : 'Descriptive, clear titles'
+            }
+        }
+    };
+}
+//# sourceMappingURL=scorer.js.map

package/packages/core/dist/sprint/scorer.js.map

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

package/packages/core/dist/sprint/status.d.ts

@@ -0,0 +1,20 @@
+import { Sprint, Feature, FeatureStatus, SprintStatus } from '../common/types.js';
+import { HardnessConfig } from '../config/schema.js';
+/**
+ * Returns the next feature to work on.
+ * Prioritizes 'in-progress' features over 'pending' to avoid silent abandonment.
+ */
+export declare function getNextFeature(sprint: Sprint): Feature | undefined;
+/**
+ * Updates the status and start/end timestamps of a feature.
+ */
+export declare function updateFeatureStatus(sprint: Sprint, featureId: string, status: FeatureStatus, timestamp?: string): void;
+/**
+ * Computes the overall sprint status based on its features' statuses.
+ */
+export declare function getSprintStatus(sprint: Sprint): SprintStatus;
+/**
+ * Closes the sprint if all features are done and there are no gate/lock errors.
+ * Saves the updated sprint to the specified path.
+ */
+export declare function closeSprint(sprint: Sprint, filePath: string, config: HardnessConfig, customRoot?: string): void;

package/packages/core/dist/sprint/status.js

@@ -0,0 +1,81 @@
+import fs from 'fs';
+import { validateSprint } from './validator.js';
+/**
+ * Returns the next feature to work on.
+ * Prioritizes 'in-progress' features over 'pending' to avoid silent abandonment.
+ */
+export function getNextFeature(sprint) {
+    const inProgress = sprint.features.find(f => f.status === 'in-progress');
+    if (inProgress) {
+        return inProgress;
+    }
+    return sprint.features.find(f => f.status === 'pending');
+}
+/**
+ * Updates the status and start/end timestamps of a feature.
+ */
+export function updateFeatureStatus(sprint, featureId, status, timestamp) {
+    const feat = sprint.features.find(f => f.id === featureId);
+    if (!feat) {
+        throw new Error(`Feature with ID "${featureId}" not found in the sprint.`);
+    }
+    feat.status = status;
+    const timeStr = timestamp || new Date().toISOString();
+    if (status === 'in-progress') {
+        if (!feat.startedAt) {
+            feat.startedAt = timeStr;
+        }
+    }
+    else if (status === 'done') {
+        if (!feat.startedAt) {
+            feat.startedAt = timeStr;
+        }
+        feat.completedAt = timeStr;
+    }
+    else if (status === 'pending') {
+        feat.startedAt = undefined;
+        feat.completedAt = undefined;
+    }
+}
+/**
+ * Computes the overall sprint status based on its features' statuses.
+ */
+export function getSprintStatus(sprint) {
+    const total = sprint.features.length;
+    if (total === 0)
+        return 'done';
+    const doneCount = sprint.features.filter(f => f.status === 'done').length;
+    const inProgressCount = sprint.features.filter(f => f.status === 'in-progress').length;
+    if (doneCount === total) {
+        return 'done';
+    }
+    if (inProgressCount > 0 || doneCount > 0) {
+        return 'in-progress';
+    }
+    return 'pending';
+}
+/**
+ * Closes the sprint if all features are done and there are no gate/lock errors.
+ * Saves the updated sprint to the specified path.
+ */
+export function closeSprint(sprint, filePath, config, customRoot) {
+    const incomplete = sprint.features.filter(f => f.status !== 'done');
+    if (incomplete.length > 0) {
+        const list = incomplete.map(f => f.id).join(', ');
+        throw new Error(`Cannot close sprint "${sprint.name}": there are incomplete features (${list})`);
+    }
+    // Mechanically validate the sprint before closing
+    const errors = validateSprint(sprint, filePath, config, customRoot);
+    if (errors.length > 0) {
+        const errorMsgs = errors.map(e => `[${e.field || 'general'}] ${e.message}`).join('\n');
+        throw new Error(`Cannot close the sprint due to validation errors:\n${errorMsgs}`);
+    }
+    sprint.status = 'done';
+    try {
+        fs.writeFileSync(filePath, JSON.stringify(sprint, null, 2), 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`Error writing the completed sprint to "${filePath}": ${error.message}`);
+    }
+}
+//# sourceMappingURL=status.js.map

package/packages/core/dist/sprint/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/sprint/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;IACzE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,SAAiB,EACjB,MAAqB,EACrB,SAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IAC3D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,oBAAoB,SAAS,4BAA4B,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACrB,MAAM,OAAO,GAAG,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEtD,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC;QAC3B,CAAC;IACH,CAAC;SAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;IAC7B,CAAC;SAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IACrC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAE/B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IAC1E,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,MAAM,CAAC;IAEvF,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,eAAe,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QACzC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,QAAgB,EAChB,MAAsB,EACtB,UAAmB;IAEnB,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACpE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,IAAI,qCAAqC,IAAI,GAAG,CAAC,CAAC;IACnG,CAAC;IAED,kDAAkD;IAClD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACpE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,SAAS,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvF,MAAM,IAAI,KAAK,CAAC,sDAAsD,SAAS,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IAEvB,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,0CAA0C,QAAQ,MAAO,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IACtG,CAAC;AACH,CAAC"}

package/packages/core/dist/sprint/validator.d.ts

@@ -0,0 +1,17 @@
+import { Sprint, SprintIndex } from '../common/types.js';
+import { HardnessConfig } from '../config/schema.js';
+export interface ValidationError {
+    file: string;
+    field?: string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+/**
+ * Checks whether a string contains template placeholders.
+ */
+export declare function hasPlaceholder(text: string): boolean;
+/**
+ * Validates the 00-index.json file.
+ */
+export declare function validateIndex(indexJson: SprintIndex, filePath: string): ValidationError[];
+export declare function validateSprint(sprint: Sprint, filePath: string, config: HardnessConfig, customRoot?: string): ValidationError[];

package/packages/core/dist/sprint/validator.js

@@ -0,0 +1,239 @@
+import path from 'path';
+import { isPathProtected } from '../common/paths.js';
+const SPRINT_FILE_RE = /^\d{2}-[a-z0-9-]+.json$/;
+const FEAT_ID_RE = /^feat-\d{3}[a-z]?$/;
+const PLACEHOLDER_RE = /<[A-Z_]+>|<<[A-Za-z0-9_-]+>>|<FILL:.*?>/;
+/**
+ * Checks whether a string contains template placeholders.
+ */
+export function hasPlaceholder(text) {
+    return PLACEHOLDER_RE.test(text);
+}
+/**
+ * Validates the 00-index.json file.
+ */
+export function validateIndex(indexJson, filePath) {
+    const errors = [];
+    const fileBasename = path.basename(filePath);
+    if (!indexJson.projectName || indexJson.projectName.trim().length === 0) {
+        errors.push({ file: fileBasename, field: 'projectName', message: 'projectName cannot be empty', severity: 'error' });
+    }
+    else if (hasPlaceholder(indexJson.projectName)) {
+        errors.push({ file: fileBasename, field: 'projectName', message: 'projectName contains placeholders', severity: 'error' });
+    }
+    if (!indexJson.specPath || indexJson.specPath.trim().length === 0) {
+        errors.push({ file: fileBasename, field: 'specPath', message: 'specPath cannot be empty', severity: 'error' });
+    }
+    // Validate totalSprints matches the sprints array length
+    if (typeof indexJson.totalSprints === 'number' && indexJson.totalSprints !== indexJson.sprints.length) {
+        errors.push({ file: fileBasename, field: 'sprints', message: `totalSprints (${indexJson.totalSprints}) does not match sprints array length (${indexJson.sprints.length})`, severity: 'error' });
+    }
+    // Validate each sprint entry
+    const SPRINT_FILE_RE_INDEX = /^\d{2}-[a-z0-9-]+\.json$/;
+    for (const entry of indexJson.sprints) {
+        if (!SPRINT_FILE_RE_INDEX.test(entry.file)) {
+            errors.push({ file: fileBasename, field: `sprints[file=${entry.file}]`, message: `Sprint file name must follow NN-kebab-case.json (received: ${entry.file})`, severity: 'error' });
+        }
+        if (!entry.name || entry.name.trim().length === 0) {
+            errors.push({ file: fileBasename, field: `sprints[file=${entry.file}].name`, message: 'sprint name cannot be empty', severity: 'error' });
+        }
+        if (typeof entry.featuresCount !== 'number' || entry.featuresCount < 1) {
+            errors.push({ file: fileBasename, field: `sprints[file=${entry.file}].featuresCount`, message: 'featuresCount must be a number >= 1', severity: 'error' });
+        }
+        if (!['pending', 'in-progress', 'done'].includes(entry.status)) {
+            errors.push({ file: fileBasename, field: `sprints[file=${entry.file}].status`, message: `invalid status: ${entry.status}`, severity: 'error' });
+        }
+    }
+    return errors;
+}
+export function validateSprint(sprint, filePath, config, customRoot) {
+    const errors = [];
+    const fileBasename = path.basename(filePath);
+    if (!SPRINT_FILE_RE.test(fileBasename)) {
+        errors.push({
+            file: fileBasename,
+            message: `File name must follow the format NN-kebab-case.json (received: ${fileBasename})`,
+            severity: 'error'
+        });
+    }
+    if (typeof sprint.index !== 'number' || sprint.index < 0) {
+        errors.push({ file: fileBasename, field: 'index', message: 'sprint index must be a number >= 0', severity: 'error' });
+    }
+    if (!sprint.name || sprint.name.trim().length === 0) {
+        errors.push({ file: fileBasename, field: 'name', message: 'sprint name cannot be empty', severity: 'error' });
+    }
+    if (!['pending', 'in-progress', 'done'].includes(sprint.status)) {
+        errors.push({ file: fileBasename, field: 'status', message: `invalid status: ${sprint.status}`, severity: 'error' });
+    }
+    if (!Array.isArray(sprint.features)) {
+        errors.push({ file: fileBasename, field: 'features', message: 'features must be an array', severity: 'error' });
+        return errors;
+    }
+    let inProgressCount = 0;
+    const featIds = new Set();
+    for (const feat of sprint.features) {
+        const fId = feat.id;
+        if (!FEAT_ID_RE.test(fId)) {
+            errors.push({
+                file: fileBasename,
+                field: `features[${fId}].id`,
+                message: `ID '${fId}' must follow the format feat-NNN[a-z]? (e.g. feat-001)`,
+                severity: 'error'
+            });
+        }
+        if (featIds.has(fId)) {
+            errors.push({ file: fileBasename, field: `features[${fId}]`, message: `Duplicate ID: ${fId}`, severity: 'error' });
+        }
+        featIds.add(fId);
+        // Basic required-field validations
+        if (!feat.title || feat.title.trim().length < 3) {
+            errors.push({ file: fileBasename, field: `features[${fId}].title`, message: 'title must be at least 3 characters', severity: 'error' });
+        }
+        if (!feat.description || feat.description.trim().length === 0) {
+            errors.push({ file: fileBasename, field: `features[${fId}].description`, message: 'description cannot be empty', severity: 'error' });
+        }
+        if (!feat.specLines || feat.specLines.trim().length === 0) {
+            errors.push({ file: fileBasename, field: `features[${fId}].specLines`, message: 'specLines cannot be empty', severity: 'error' });
+        }
+        if (!Array.isArray(feat.acceptanceCriteria) || feat.acceptanceCriteria.length < 2) {
+            errors.push({
+                file: fileBasename,
+                field: `features[${fId}].acceptanceCriteria`,
+                message: 'must contain at least 2 acceptance criteria',
+                severity: 'error'
+            });
+        }
+        if (!Array.isArray(feat.hints) || feat.hints.length < 1) {
+            errors.push({ file: fileBasename, field: `features[${fId}].hints`, message: 'must contain at least 1 hint', severity: 'error' });
+        }
+        // Validate status and dates
+        if (!['pending', 'in-progress', 'done'].includes(feat.status)) {
+            errors.push({ file: fileBasename, field: `features[${fId}].status`, message: `invalid status: ${feat.status}`, severity: 'error' });
+        }
+        if (feat.status === 'in-progress') {
+            inProgressCount++;
+            if (!feat.startedAt) {
+                errors.push({ file: fileBasename, field: `features[${fId}].startedAt`, message: 'in-progress status requires startedAt', severity: 'error' });
+            }
+        }
+        if (feat.status === 'done') {
+            if (!feat.completedAt) {
+                errors.push({ file: fileBasename, field: `features[${fId}].completedAt`, message: 'done status requires completedAt', severity: 'error' });
+            }
+        }
+        // Placeholders check
+        const checkPlaceholders = (text, fieldName) => {
+            if (hasPlaceholder(text)) {
+                errors.push({ file: fileBasename, field: `features[${fId}].${fieldName}`, message: `Contains unfilled placeholders`, severity: 'error' });
+            }
+        };
+        checkPlaceholders(feat.title, 'title');
+        checkPlaceholders(feat.description, 'description');
+        feat.acceptanceCriteria.forEach((ac, idx) => checkPlaceholders(ac, `acceptanceCriteria[${idx}]`));
+        feat.hints.forEach((hint, idx) => checkPlaceholders(hint, `hints[${idx}]`));
+        // Files validation
+        if (!Array.isArray(feat.files)) {
+            errors.push({ file: fileBasename, field: `features[${fId}].files`, message: 'files must be an array', severity: 'error' });
+        }
+        else {
+            let hasTsFiles = false;
+            for (const fileEntry of feat.files) {
+                const filePathStr = typeof fileEntry === 'string' ? fileEntry : fileEntry.file;
+                if (hasPlaceholder(filePathStr)) {
+                    errors.push({ file: fileBasename, field: `features[${fId}].files`, message: `File path contains placeholder: ${filePathStr}`, severity: 'error' });
+                }
+                if (isPathProtected(filePathStr, customRoot)) {
+                    errors.push({
+                        file: fileBasename,
+                        field: `features[${fId}].files`,
+                        message: `File in protected area not allowed: ${filePathStr}`,
+                        severity: 'error'
+                    });
+                }
+                if (/\.(ts|tsx|cts|mts)$/.test(filePathStr)) {
+                    hasTsFiles = true;
+                }
+            }
+            // TypeScript parsing vs typecheck check
+            if (hasTsFiles && feat.verification.parseable && !feat.verification.typecheck) {
+                errors.push({
+                    file: fileBasename,
+                    field: `features[${fId}].verification`,
+                    message: 'TypeScript files with parseable=true require typecheck=true',
+                    severity: 'error'
+                });
+            }
+        }
+        // grepFiles validation
+        if (feat.verification.grepFiles) {
+            for (const grepFile of feat.verification.grepFiles) {
+                if (isPathProtected(grepFile, customRoot)) {
+                    errors.push({
+                        file: fileBasename,
+                        field: `features[${fId}].verification.grepFiles`,
+                        message: `grepFile path in protected area not allowed: ${grepFile}`,
+                        severity: 'error'
+                    });
+                }
+            }
+        }
+        // Dependencies manifest validation
+        if (feat.verification.dependencies) {
+            for (const dep of feat.verification.dependencies) {
+                if (dep.manifest && isPathProtected(dep.manifest, customRoot)) {
+                    errors.push({
+                        file: fileBasename,
+                        field: `features[${fId}].verification.dependencies`,
+                        message: `Dependencies manifest in protected area not allowed: ${dep.manifest}`,
+                        severity: 'error'
+                    });
+                }
+            }
+        }
+        // Smoke command validation
+        if (feat.verification.smoke) {
+            const smoke = feat.verification.smoke;
+            if (smoke.executedBy !== 'workflow') {
+                errors.push({
+                    file: fileBasename,
+                    field: `features[${fId}].verification.smoke.executedBy`,
+                    message: 'executedBy in smoke command must be "workflow"',
+                    severity: 'error'
+                });
+            }
+            // Security validation of the smoke command
+            const command = smoke.command;
+            if (hasPlaceholder(command)) {
+                errors.push({
+                    file: fileBasename,
+                    field: `features[${fId}].verification.smoke.command`,
+                    message: 'Smoke command contains placeholders',
+                    severity: 'error'
+                });
+            }
+            // Check command against config security
+            const blockPatterns = config.security.blockedPatterns;
+            for (const pattern of blockPatterns) {
+                const regex = new RegExp(pattern);
+                if (regex.test(command)) {
+                    errors.push({
+                        file: fileBasename,
+                        field: `features[${fId}].verification.smoke.command`,
+                        message: `Smoke command blocked by security policy (pattern: "${pattern}")`,
+                        severity: 'error'
+                    });
+                }
+            }
+        }
+    }
+    if (inProgressCount > 1) {
+        errors.push({
+            file: fileBasename,
+            field: 'features',
+            message: `Maximum of 1 in-progress feature per sprint (found: ${inProgressCount})`,
+            severity: 'error'
+        });
+    }
+    return errors;
+}
+//# sourceMappingURL=validator.js.map

package/packages/core/dist/sprint/validator.js.map

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

package/packages/core/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@hardness/core",
+  "version": "1.0.0",
+  "description": "Hardness Core — orchestrator, gates, locks, config and security",
+  "author": "cmt-t",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "tsc --build --clean"
+  },
+  "dependencies": {
+    "@hardness/analyzers": "*",
+    "@hardness/prompts": "*",
+    "picocolors": "^1.0.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.7"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cmt-t/HardNess.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/cmt-t/HardNess/issues"
+  },
+  "homepage": "https://github.com/cmt-t/HardNess#readme",
+  "keywords": [
+    "ai",
+    "agent",
+    "orchestrator",
+    "gates",
+    "locks",
+    "validation"
+  ]
+}

package/packages/prompts/README.md

@@ -0,0 +1,30 @@
+# @hardness/prompts
+
+Role-based prompt templates and renderer for [Hardness](https://github.com/cmt-t/HardNess).
+
+## Usage
+
+```typescript
+import { renderPrompt, IMPLEMENTER_TEMPLATE } from '@hardness/prompts';
+
+const prompt = renderPrompt(IMPLEMENTER_TEMPLATE, {
+  projectName: 'my-app',
+  sprintIndex: '0',
+  featureId: 'feat-001',
+  featureTitle: 'Bootstrap',
+  featureDescription: 'Set up the monorepo',
+  acceptanceCriteria: '- npm install runs without errors',
+  hints: '- Use npm workspaces',
+  specExcerpt: '...',
+  existingFiles: '- package.json (new)',
+  rules: '- No deps without review',
+});
+```
+
+Templates: `IMPLEMENTER_TEMPLATE`, `REVIEWER_TEMPLATE`, `AUDITOR_TEMPLATE`.
+
+See the [main repo](https://github.com/cmt-t/HardNess#readme) for full documentation.
+
+## License
+
+MIT © 2026 cmt-t

package/packages/prompts/dist/index.d.ts

@@ -0,0 +1,21 @@
+export declare const name = "@hardness/prompts";
+export interface PromptVariables {
+    rules?: string;
+    context?: string;
+    projectName?: string;
+    sprintIndex?: string;
+    featureId?: string;
+    featureTitle?: string;
+    featureDescription?: string;
+    acceptanceCriteria?: string;
+    hints?: string;
+    specExcerpt?: string;
+    existingFiles?: string;
+}
+/**
+ * Renders a template by substituting the provided variables.
+ */
+export declare function renderPrompt(template: string, vars: Record<string, string>): string;
+export declare const IMPLEMENTER_TEMPLATE = "\n# AGENT IMPLEMENTATION INSTRUCTIONS\nYou are an elite software development agent operating under the **Hardness** orchestrator.\nYour task is to implement the current feature, strictly following the security, quality and constraint rules below.\n\n## Project Information\n- Project: {projectName}\n- Active sprint: Sprint {sprintIndex}\n- Feature: {featureId} - {featureTitle}\n- Feature description: {featureDescription}\n\n## Acceptance Criteria\n{acceptanceCriteria}\n\n## Development Hints\n{hints}\n\n## Related excerpt from SPEC.md\n{specExcerpt}\n\n## Editable Files\nOnly the files listed in the feature above may be created or modified:\n{existingFiles}\n\n## Global Rules and Policies\n{rules}\n\n---\nIMPORTANT:\n1. DO NOT modify files that are not listed in the feature above (violation triggers a critical gate failure).\n2. Do not add dependencies not listed without authorization.\n3. Do not use console.log without necessity; prefer a formal logger.\n";
+export declare const REVIEWER_TEMPLATE = "\n# CODE REVIEW (REVIEWER)\nReview the code changes made for feature {featureId} - {featureTitle}.\nEnsure that the acceptance criteria have been fully met.\n\nCriteria:\n{acceptanceCriteria}\n\nCheck:\n1. Whether formatting rules were maintained.\n2. Whether there are leaked keys or secrets.\n3. Whether unit tests cover the new behavior.\n";
+export declare const AUDITOR_TEMPLATE = "\n# FINAL CONSISTENCY AUDIT (AUDITOR)\nAnalyze the overall state of project {projectName} after the implementations of sprint {sprintIndex}.\nEnsure the code is clean, that there are no pending circular imports and that the project conventions are consistent.\n";