ai-devkit 0.11.0 → 0.13.0

package/dist/services/lint/rules/base-docs.rule.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBaseDocsRules = runBaseDocsRules;
+const constants_1 = require("../constants");
+const phase_docs_rule_1 = require("./phase-docs.rule");
+function runBaseDocsRules(cwd, deps) {
+    return (0, phase_docs_rule_1.runPhaseDocRules)({
+        cwd,
+        phases: constants_1.LIFECYCLE_PHASES,
+        idPrefix: 'base',
+        category: 'base-docs',
+        filePathForPhase: (phase) => `${constants_1.DOCS_DIR}/${phase}/README.md`,
+        missingFix: 'Run: npx ai-devkit init',
+        deps
+    });
+}
+//# sourceMappingURL=base-docs.rule.js.map

package/dist/services/lint/rules/base-docs.rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-docs.rule.js","sourceRoot":"","sources":["../../../../src/services/lint/rules/base-docs.rule.ts"],"names":[],"mappings":";;AAIA,4CAUC;AAdD,4CAA0D;AAE1D,uDAAqD;AAErD,SAAgB,gBAAgB,CAAC,GAAW,EAAE,IAAsB;IAClE,OAAO,IAAA,kCAAgB,EAAC;QACtB,GAAG;QACH,MAAM,EAAE,4BAAgB;QACxB,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE,WAAW;QACrB,gBAAgB,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,oBAAQ,IAAI,KAAK,YAAY;QACrE,UAAU,EAAE,yBAAyB;QACrC,IAAI;KACL,CAAC,CAAC;AACL,CAAC"}

package/dist/services/lint/rules/check-factories.d.ts

@@ -0,0 +1,5 @@
+import { LintCheckResult } from '../types';
+export declare function createOkCheck(id: string, category: LintCheckResult['category'], message: string): LintCheckResult;
+export declare function createMissingCheck(id: string, category: LintCheckResult['category'], message: string, fix?: string): LintCheckResult;
+export declare function createWarnCheck(id: string, category: LintCheckResult['category'], message: string, fix?: string): LintCheckResult;
+//# sourceMappingURL=check-factories.d.ts.map

package/dist/services/lint/rules/check-factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-factories.d.ts","sourceRoot":"","sources":["../../../../src/services/lint/rules/check-factories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,EACrC,OAAO,EAAE,MAAM,GACd,eAAe,CAQjB;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,eAAe,CASjB;AAED,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,eAAe,CASjB"}

package/dist/services/lint/rules/check-factories.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOkCheck = createOkCheck;
+exports.createMissingCheck = createMissingCheck;
+exports.createWarnCheck = createWarnCheck;
+const constants_1 = require("../constants");
+function createOkCheck(id, category, message) {
+    return {
+        id,
+        level: constants_1.LINT_LEVEL.OK,
+        category,
+        required: false,
+        message
+    };
+}
+function createMissingCheck(id, category, message, fix) {
+    return {
+        id,
+        level: constants_1.LINT_LEVEL.MISS,
+        category,
+        required: true,
+        message,
+        fix
+    };
+}
+function createWarnCheck(id, category, message, fix) {
+    return {
+        id,
+        level: constants_1.LINT_LEVEL.WARN,
+        category,
+        required: false,
+        message,
+        fix
+    };
+}
+//# sourceMappingURL=check-factories.js.map

package/dist/services/lint/rules/check-factories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-factories.js","sourceRoot":"","sources":["../../../../src/services/lint/rules/check-factories.ts"],"names":[],"mappings":";;AAGA,sCAYC;AAED,gDAcC;AAED,0CAcC;AA9CD,4CAA0C;AAE1C,SAAgB,aAAa,CAC3B,EAAU,EACV,QAAqC,EACrC,OAAe;IAEf,OAAO;QACL,EAAE;QACF,KAAK,EAAE,sBAAU,CAAC,EAAE;QACpB,QAAQ;QACR,QAAQ,EAAE,KAAK;QACf,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAChC,EAAU,EACV,QAAqC,EACrC,OAAe,EACf,GAAY;IAEZ,OAAO;QACL,EAAE;QACF,KAAK,EAAE,sBAAU,CAAC,IAAI;QACtB,QAAQ;QACR,QAAQ,EAAE,IAAI;QACd,OAAO;QACP,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,SAAgB,eAAe,CAC7B,EAAU,EACV,QAAqC,EACrC,OAAe,EACf,GAAY;IAEZ,OAAO;QACL,EAAE;QACF,KAAK,EAAE,sBAAU,CAAC,IAAI;QACtB,QAAQ;QACR,QAAQ,EAAE,KAAK;QACf,OAAO;QACP,GAAG;KACJ,CAAC;AACJ,CAAC"}

package/dist/services/lint/rules/feature-docs.rule.d.ts

@@ -0,0 +1,3 @@
+import { LintCheckResult, LintDependencies } from '../types';
+export declare function runFeatureDocsRules(cwd: string, normalizedName: string, deps: LintDependencies): LintCheckResult[];
+//# sourceMappingURL=feature-docs.rule.d.ts.map

package/dist/services/lint/rules/feature-docs.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-docs.rule.d.ts","sourceRoot":"","sources":["../../../../src/services/lint/rules/feature-docs.rule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG7D,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,gBAAgB,GACrB,eAAe,EAAE,CASnB"}

package/dist/services/lint/rules/feature-docs.rule.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runFeatureDocsRules = runFeatureDocsRules;
+const constants_1 = require("../constants");
+const phase_docs_rule_1 = require("./phase-docs.rule");
+function runFeatureDocsRules(cwd, normalizedName, deps) {
+    return (0, phase_docs_rule_1.runPhaseDocRules)({
+        cwd,
+        phases: constants_1.LIFECYCLE_PHASES,
+        idPrefix: 'feature-doc',
+        category: 'feature-docs',
+        filePathForPhase: (phase) => `${constants_1.DOCS_DIR}/${phase}/feature-${normalizedName}.md`,
+        deps
+    });
+}
+//# sourceMappingURL=feature-docs.rule.js.map

package/dist/services/lint/rules/feature-docs.rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-docs.rule.js","sourceRoot":"","sources":["../../../../src/services/lint/rules/feature-docs.rule.ts"],"names":[],"mappings":";;AAIA,kDAaC;AAjBD,4CAA0D;AAE1D,uDAAqD;AAErD,SAAgB,mBAAmB,CACjC,GAAW,EACX,cAAsB,EACtB,IAAsB;IAEtB,OAAO,IAAA,kCAAgB,EAAC;QACtB,GAAG;QACH,MAAM,EAAE,4BAAgB;QACxB,QAAQ,EAAE,aAAa;QACvB,QAAQ,EAAE,cAAc;QACxB,gBAAgB,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,oBAAQ,IAAI,KAAK,YAAY,cAAc,KAAK;QACxF,IAAI;KACL,CAAC,CAAC;AACL,CAAC"}

package/dist/services/lint/rules/feature-name.rule.d.ts

@@ -0,0 +1,7 @@
+import { FeatureTarget, LintCheckResult } from '../types';
+export declare function normalizeFeatureName(input: string): string;
+export declare function validateFeatureNameRule(rawFeature: string): {
+    target: FeatureTarget;
+    check?: LintCheckResult;
+};
+//# sourceMappingURL=feature-name.rule.d.ts.map

package/dist/services/lint/rules/feature-name.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-name.rule.d.ts","sourceRoot":"","sources":["../../../../src/services/lint/rules/feature-name.rule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG1D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG;IAC3D,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB,CAqBA"}

package/dist/services/lint/rules/feature-name.rule.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeFeatureName = normalizeFeatureName;
+exports.validateFeatureNameRule = validateFeatureNameRule;
+const constants_1 = require("../constants");
+const check_factories_1 = require("./check-factories");
+function normalizeFeatureName(input) {
+    const trimmed = input.trim();
+    return trimmed.startsWith('feature-') ? trimmed.slice('feature-'.length) : trimmed;
+}
+function validateFeatureNameRule(rawFeature) {
+    const normalizedName = normalizeFeatureName(rawFeature);
+    const target = {
+        raw: rawFeature,
+        normalizedName,
+        branchName: `feature-${normalizedName}`
+    };
+    if (constants_1.FEATURE_NAME_PATTERN.test(normalizedName)) {
+        return { target };
+    }
+    return {
+        target,
+        check: (0, check_factories_1.createMissingCheck)('feature-name', 'feature-docs', `Invalid feature name: ${rawFeature}`, 'Use kebab-case and optionally prefix with feature- (example: lint-command or feature-lint-command).')
+    };
+}
+//# sourceMappingURL=feature-name.rule.js.map

package/dist/services/lint/rules/feature-name.rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-name.rule.js","sourceRoot":"","sources":["../../../../src/services/lint/rules/feature-name.rule.ts"],"names":[],"mappings":";;AAIA,oDAGC;AAED,0DAwBC;AAjCD,4CAAoD;AAEpD,uDAAuD;AAEvD,SAAgB,oBAAoB,CAAC,KAAa;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACrF,CAAC;AAED,SAAgB,uBAAuB,CAAC,UAAkB;IAIxD,MAAM,cAAc,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACxD,MAAM,MAAM,GAAkB;QAC5B,GAAG,EAAE,UAAU;QACf,cAAc;QACd,UAAU,EAAE,WAAW,cAAc,EAAE;KACxC,CAAC;IAEF,IAAI,gCAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;IAED,OAAO;QACL,MAAM;QACN,KAAK,EAAE,IAAA,oCAAkB,EACvB,cAAc,EACd,cAAc,EACd,yBAAyB,UAAU,EAAE,EACrC,qGAAqG,CACtG;KACF,CAAC;AACJ,CAAC"}

package/dist/services/lint/rules/git-worktree.rule.d.ts

@@ -0,0 +1,3 @@
+import { LintCheckResult, LintDependencies } from '../types';
+export declare function runGitWorktreeRules(cwd: string, branchName: string, deps: LintDependencies): LintCheckResult[];
+//# sourceMappingURL=git-worktree.rule.d.ts.map

package/dist/services/lint/rules/git-worktree.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree.rule.d.ts","sourceRoot":"","sources":["../../../../src/services/lint/rules/git-worktree.rule.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG7D,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,gBAAgB,GACrB,eAAe,EAAE,CAgDnB"}

package/dist/services/lint/rules/git-worktree.rule.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGitWorktreeRules = runGitWorktreeRules;
+const git_1 = require("../../../util/git");
+const check_factories_1 = require("./check-factories");
+function runGitWorktreeRules(cwd, branchName, deps) {
+    const checks = [];
+    if (!(0, git_1.isInsideGitWorkTreeSync)(cwd, deps.execFileSync)) {
+        checks.push((0, check_factories_1.createMissingCheck)('git-repo', 'git-worktree', 'Current directory is not inside a git repository', 'Run lint --feature from the repository root or a repo worktree.'));
+        return checks;
+    }
+    const branchExists = (0, git_1.localBranchExistsSync)(cwd, branchName, deps.execFileSync);
+    if (!branchExists) {
+        checks.push((0, check_factories_1.createMissingCheck)('git-branch', 'git-worktree', `Branch ${branchName} does not exist`, `Run: git worktree add -b ${branchName} ../${branchName}`));
+        return checks;
+    }
+    checks.push((0, check_factories_1.createOkCheck)('git-branch', 'git-worktree', `Branch ${branchName} exists`));
+    const worktreePaths = (0, git_1.getWorktreePathsForBranchSync)(cwd, branchName, deps.execFileSync);
+    if (worktreePaths.length === 0) {
+        checks.push((0, check_factories_1.createWarnCheck)('git-worktree', 'git-worktree', `No dedicated worktree registered for ${branchName}`, `Suggested: git worktree add ../${branchName} ${branchName}`));
+        return checks;
+    }
+    checks.push((0, check_factories_1.createOkCheck)('git-worktree', 'git-worktree', `Worktree detected for ${branchName}: ${worktreePaths.join(', ')}`));
+    return checks;
+}
+//# sourceMappingURL=git-worktree.rule.js.map

package/dist/services/lint/rules/git-worktree.rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree.rule.js","sourceRoot":"","sources":["../../../../src/services/lint/rules/git-worktree.rule.ts"],"names":[],"mappings":";;AAQA,kDAoDC;AA5DD,2CAI2B;AAE3B,uDAAuF;AAEvF,SAAgB,mBAAmB,CACjC,GAAW,EACX,UAAkB,EAClB,IAAsB;IAEtB,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,IAAI,CAAC,IAAA,6BAAuB,EAAC,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QACrD,MAAM,CAAC,IAAI,CACT,IAAA,oCAAkB,EAChB,UAAU,EACV,cAAc,EACd,kDAAkD,EAClD,iEAAiE,CAClE,CACF,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,YAAY,GAAG,IAAA,2BAAqB,EAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/E,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CACT,IAAA,oCAAkB,EAChB,YAAY,EACZ,cAAc,EACd,UAAU,UAAU,iBAAiB,EACrC,4BAA4B,UAAU,OAAO,UAAU,EAAE,CAC1D,CACF,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAA,+BAAa,EAAC,YAAY,EAAE,cAAc,EAAE,UAAU,UAAU,SAAS,CAAC,CAAC,CAAC;IAExF,MAAM,aAAa,GAAG,IAAA,mCAA6B,EAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACxF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CACT,IAAA,iCAAe,EACb,cAAc,EACd,cAAc,EACd,wCAAwC,UAAU,EAAE,EACpD,kCAAkC,UAAU,IAAI,UAAU,EAAE,CAC7D,CACF,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,IAAI,CACT,IAAA,+BAAa,EAAC,cAAc,EAAE,cAAc,EAAE,yBAAyB,UAAU,KAAK,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAClH,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/services/lint/rules/phase-docs.rule.d.ts

@@ -0,0 +1,13 @@
+import { LintCheckResult, LintDependencies } from '../types';
+interface PhaseDocRuleParams {
+    cwd: string;
+    phases: readonly string[];
+    idPrefix: string;
+    category: LintCheckResult['category'];
+    filePathForPhase: (phase: string) => string;
+    missingFix?: string;
+    deps: LintDependencies;
+}
+export declare function runPhaseDocRules(params: PhaseDocRuleParams): LintCheckResult[];
+export {};
+//# sourceMappingURL=phase-docs.rule.d.ts.map

package/dist/services/lint/rules/phase-docs.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-docs.rule.d.ts","sourceRoot":"","sources":["../../../../src/services/lint/rules/phase-docs.rule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG7D,UAAU,kBAAkB;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IACtC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,EAAE,CAkB9E"}

package/dist/services/lint/rules/phase-docs.rule.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPhaseDocRules = runPhaseDocRules;
+const path = __importStar(require("path"));
+const check_factories_1 = require("./check-factories");
+function runPhaseDocRules(params) {
+    const checks = [];
+    const { cwd, phases, idPrefix, category, filePathForPhase, missingFix, deps } = params;
+    for (const phase of phases) {
+        const relativePath = filePathForPhase(phase);
+        const absolutePath = path.join(cwd, relativePath);
+        const id = `${idPrefix}-${phase}`;
+        if (deps.existsSync(absolutePath)) {
+            checks.push((0, check_factories_1.createOkCheck)(id, category, relativePath));
+            continue;
+        }
+        checks.push((0, check_factories_1.createMissingCheck)(id, category, relativePath, missingFix));
+    }
+    return checks;
+}
+//# sourceMappingURL=phase-docs.rule.js.map

package/dist/services/lint/rules/phase-docs.rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-docs.rule.js","sourceRoot":"","sources":["../../../../src/services/lint/rules/phase-docs.rule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,4CAkBC;AAhCD,2CAA6B;AAE7B,uDAAsE;AAYtE,SAAgB,gBAAgB,CAAC,MAA0B;IACzD,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAEvF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAClD,MAAM,EAAE,GAAG,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC;QAElC,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,IAAA,+BAAa,EAAC,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;YACvD,SAAS;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,IAAA,oCAAkB,EAAC,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/services/lint/types.d.ts

@@ -0,0 +1,39 @@
+import { GitExecFileSync } from '../../util/git';
+import { LINT_LEVEL } from './constants';
+export interface LintOptions {
+    feature?: string;
+    json?: boolean;
+}
+export type LintLevel = (typeof LINT_LEVEL)[keyof typeof LINT_LEVEL];
+export interface LintCheckResult {
+    id: string;
+    level: LintLevel;
+    category: 'base-docs' | 'feature-docs' | 'git-worktree';
+    required: boolean;
+    message: string;
+    fix?: string;
+}
+export interface LintReport {
+    cwd: string;
+    feature?: FeatureTarget;
+    checks: LintCheckResult[];
+    summary: {
+        ok: number;
+        miss: number;
+        warn: number;
+        requiredFailures: number;
+    };
+    pass: boolean;
+    exitCode: 0 | 1;
+}
+export interface FeatureTarget {
+    raw: string;
+    normalizedName: string;
+    branchName: string;
+}
+export interface LintDependencies {
+    cwd: () => string;
+    existsSync: (targetPath: string) => boolean;
+    execFileSync: GitExecFileSync;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/lint/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/lint/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,WAAW,GAAG,cAAc,GAAG,cAAc,CAAC;IACxD,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,YAAY,EAAE,eAAe,CAAC;CAC/B"}

package/dist/services/lint/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/services/lint/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/lint/types.ts"],"names":[],"mappings":""}

package/dist/templates/commands/capture-knowledge.md

@@ -1,50 +1,12 @@
 ---
-description: Capture structured knowledge about a code entry point and save it to the knowledge docs.
+description: Document a code entry point in knowledge docs.
 ---
 
-# Knowledge Capture Assistant
-
 Guide me through creating a structured understanding of a code entry point and saving it to the knowledge docs.
 
-## Step 1: Gather Context
-- Entry point (file, folder, function, API)
-- Why this entry point matters (feature, bug, investigation)
-- Relevant requirements/design docs (if any)
-- Desired depth or focus areas (logic, dependencies, data flow)
-
-## Step 2: Validate Entry Point
-- Determine entry point type and confirm it exists
-- Surface ambiguity (multiple matches) and ask for clarification
-- If not found, suggest likely alternatives or spelling fixes
-
-## Step 3: Collect Source Context
-- Read the primary file/module and summarize purpose, exports, key patterns
-- For folders: list structure, highlight key modules
-- For functions/APIs: capture signature, parameters, return values, error handling
-- Extract essential snippets (avoid large dumps)
-
-## Step 4: Analyze Dependencies
-- Build a dependency view up to depth 3
-- Track visited nodes to avoid loops
-- Categorize dependencies (imports, function calls, services, external packages)
-- Note important external systems or generated code that should be excluded
-
-## Step 5: Synthesize Explanation
-- Draft an overview (purpose, language, high-level behavior)
-- Detail core logic, key components, execution flow, patterns
-- Highlight error handling, performance, security considerations
-- Identify potential improvements or risks discovered during analysis
-
-## Step 6: Create Documentation
-- Normalize entry point name to kebab-case (`calculateTotalPrice` → `calculate-total-price`)
-- Create `docs/ai/implementation/knowledge-{name}.md` using the headings implied in Step 5 (Overview, Implementation Details, Dependencies, Visual Diagrams, Additional Insights, Metadata, Next Steps)
-- Populate sections with findings, diagrams, and metadata (analysis date, depth, files touched)
-- Include mermaid diagrams when they clarify flows or relationships
-
-## Step 7: Review & Next Actions
-- Summarize key insights and open questions for follow-up
-- Suggest related areas for deeper dives or refactors
-- Confirm the knowledge file path and remind to commit it
-- Encourage running `/capture-knowledge` again for related entry points if needed
-
-Let me know the entry point and goals when you’re ready to begin the knowledge capture.
+1. **Gather & Validate Entry Point** — If not already provided, ask for: entry point (file, folder, function, API), why it matters (feature, bug, investigation), and desired depth or focus areas. Confirm the entry point exists; if ambiguous or not found, clarify or suggest alternatives.
+2. **Collect Source Context** — Read the primary file/module and summarize purpose, exports, key patterns. For folders: list structure, highlight key modules. For functions/APIs: capture signature, parameters, return values, error handling. Extract essential snippets (avoid large dumps).
+3. **Analyze Dependencies** — Build a dependency view up to depth 3, tracking visited nodes to avoid loops. Categorize: imports, function calls, services, external packages. Note external systems or generated code to exclude.
+4. **Synthesize Explanation** — Draft overview (purpose, language, high-level behavior). Detail core logic, execution flow, key patterns. Highlight error handling, performance, security considerations. Identify potential improvements or risks.
+5. **Create Documentation** — Normalize name to kebab-case (`calculateTotalPrice` → `calculate-total-price`). Create `docs/ai/implementation/knowledge-{name}.md` with sections: Overview, Implementation Details, Dependencies, Visual Diagrams, Additional Insights, Metadata, Next Steps. Include mermaid diagrams when they clarify flows or relationships. Add metadata (analysis date, depth, files touched).
+6. **Review & Next Actions** — Summarize key insights and open questions. Suggest related areas for deeper dives. Confirm file path and remind to commit.

package/dist/templates/commands/check-implementation.md

@@ -2,24 +2,9 @@
 description: Compare implementation with design and requirements docs to ensure alignment.
 ---
 
-Compare the current implementation with the design in docs/ai/design/ and requirements in docs/ai/requirements/. Please follow this structured review:
-
-1. Ask me for:
-   - Feature/branch description
-   - List of modified files
-   - Relevant design doc(s) (feature-specific and/or project-level)
-   - Any known constraints or assumptions
-
-2. For each design doc:
-   - Summarize key architectural decisions and constraints
-   - Highlight components, interfaces, and data flows that must be respected
-
-3. File-by-file comparison:
-   - Confirm implementation matches design intent
-   - Note deviations or missing pieces
-   - Flag logic gaps, edge cases, or security issues
-   - Suggest simplifications or refactors
-   - Identify missing tests or documentation updates
+Compare the current implementation with the design in docs/ai/design/ and requirements in docs/ai/requirements/.
 
+1. If not already provided, ask for: feature/branch description, list of modified files, relevant design doc(s), and any known constraints or assumptions.
+2. For each design doc: summarize key architectural decisions and constraints, highlight components, interfaces, and data flows that must be respected.
+3. File-by-file comparison: confirm implementation matches design intent, note deviations or missing pieces, flag logic gaps, edge cases, or security issues, suggest simplifications or refactors, and identify missing tests or documentation updates.
 4. Summarize findings with recommended next steps.
-

package/dist/templates/commands/code-review.md

@@ -1,85 +1,11 @@
 ---
-description: Perform a local code review before pushing changes, ensuring alignment with design docs and best practices.
+description: Pre-push code review against design docs.
 ---
 
-# Local Code Review Assistant
+Perform a local code review **before** pushing changes.
 
-You are helping me perform a local code review **before** I push changes. Please follow this structured workflow.
-
-## Step 1: Gather Context
-Ask me for:
-- Brief feature/branch description
-- List of modified files (with optional summaries)
-- Relevant design doc(s) (e.g., `docs/ai/design/feature-{name}.md` or project-level design)
-- Any known constraints or risky areas
-- Any open bugs or TODOs linked to this work
-- Which tests have already been run
-
-If possible, request the latest diff:
-```bash
-git status -sb
-git diff --stat
-```
-
-## Step 2: Understand Design Alignment
-For each provided design doc:
-- Summarize the architectural intent
-- Note critical requirements, patterns, or constraints the design mandates
-
-## Step 3: File-by-File Review
-For every modified file:
-1. Highlight deviations from the referenced design or requirements
-2. Spot potential logic or flow issues and edge cases
-3. Identify redundant or duplicate code
-4. Suggest simplifications or refactors (prefer clarity over cleverness)
-5. Flag security concerns (input validation, secrets, auth, data handling)
-6. Check for performance pitfalls or scalability risks
-7. Ensure error handling, logging, and observability are appropriate
-8. Note any missing comments or docs
-9. Flag missing or outdated tests related to this file
-
-## Step 4: Cross-Cutting Concerns
-- Verify naming consistency and adherence to project conventions
-- Confirm documentation/comments are updated where the behavior changed
-- Identify missing tests (unit, integration, E2E) needed to cover the changes
-- Ensure configuration/migration updates are captured if applicable
-
-## Step 5: Summarize Findings
-Provide results in this structure:
-```
-### Summary
-- Blocking issues: [count]
-- Important follow-ups: [count]
-- Nice-to-have improvements: [count]
-
-### Detailed Notes
-1. **[File or Component]**
-   - Issue/Observation: ...
-   - Impact: (e.g., blocking / important / nice-to-have)
-   - Recommendation: ...
-   - Design reference: [...]
-
-2. ... (repeat per finding)
-
-### Recommended Next Steps
-- [ ] Address blocking issues
-- [ ] Update design/implementation docs if needed
-- [ ] Add/adjust tests:
-      - Unit:
-      - Integration:
-      - E2E:
-- [ ] Rerun local test suite
-- [ ] Re-run code review command after fixes
-```
-
-## Step 6: Final Checklist
-Confirm whether each item is complete (yes/no/needs follow-up):
-- Implementation matches design & requirements
-- No obvious logic or edge-case gaps remain
-- Redundant code removed or justified
-- Security considerations addressed
-- Tests cover new/changed behavior
-- Documentation/design notes updated
-
----
-Let me know when you're ready to begin the review.
+1. **Gather Context** — If not already provided, ask for: feature/branch description, list of modified files, relevant design doc(s) (e.g., `docs/ai/design/feature-{name}.md`), known constraints or risky areas, and which tests have been run. Also review the latest diff via `git status` and `git diff --stat`.
+2. **Understand Design Alignment** — For each design doc, summarize architectural intent and critical constraints.
+3. **File-by-File Review** — For every modified file: check alignment with design/requirements and flag deviations, spot logic issues/edge cases/redundant code, flag security concerns (input validation, secrets, auth, data handling), check error handling/performance/observability, and identify missing or outdated tests.
+4. **Cross-Cutting Concerns** — Verify naming consistency and project conventions. Confirm docs/comments updated where behavior changed. Identify missing tests (unit, integration, E2E). Check for needed configuration/migration updates.
+5. **Summarize Findings** — Categorize each finding as **blocking**, **important**, or **nice-to-have** with: file, issue, impact, recommendation, and design reference.

package/dist/templates/commands/debug.md

@@ -1,49 +1,11 @@
 ---
-description: Guide me through debugging a code issue by clarifying expectations, identifying gaps, and agreeing on a fix plan before changing code.
+description: Debug an issue with structured root-cause analysis before changing code.
 ---
 
-# Local Debugging Assistant
-
-Help me debug an issue by clarifying expectations, identifying gaps, and agreeing on a fix plan before changing code.
-
-## Step 1: Gather Context
-Ask me for:
-- Brief issue description (what is happening?)
-- Expected behavior or acceptance criteria (what should happen?)
-- Current behavior and any error messages/logs
-- Recent related changes or deployments
-- Scope of impact (users, services, environments)
-
-## Step 2: Clarify Reality vs Expectation
-- Restate the observed behavior vs the expected outcome
-- Confirm relevant requirements, tickets, or docs that define the expectation
-- Identify acceptance criteria for the fix (how we know it is resolved)
-
-## Step 3: Reproduce & Isolate
-- Determine reproducibility (always, intermittent, environment-specific)
-- Capture reproduction steps or commands
-- Note any available tests that expose the failure
-- List suspected components, services, or modules
-
-## Step 4: Analyze Potential Causes
-- Brainstorm plausible root causes (data, config, code regressions, external dependencies)
-- Gather supporting evidence (logs, metrics, traces, screenshots)
-- Highlight gaps or unknowns that need investigation
-
-## Step 5: Surface Options
-- Present possible resolution paths (quick fix, deeper refactor, rollback, feature flag, etc.)
-- For each option, list pros/cons, risks, and verification steps
-- Consider required approvals or coordination
-
-## Step 6: Confirm Path Forward
-- Ask which option we should pursue
-- Summarize chosen approach, required pre-work, and success criteria
-- Plan validation steps (tests, monitoring, user sign-off)
-
-## Step 7: Next Actions & Tracking
-- Document tasks, owners, and timelines for the selected option
-- Note follow-up actions after deployment (monitoring, comms, postmortem if needed)
-- Encourage updating relevant docs/tests once resolved
-
-Let me know when you're ready to walk through the debugging flow.
+Help me debug an issue. Clarify expectations, identify gaps, and agree on a fix plan before changing code.
 
+1. **Gather Context** — If not already provided, ask for: issue description (what is happening vs what should happen), error messages/logs/screenshots, recent related changes or deployments, and scope of impact.
+2. **Clarify Reality vs Expectation** — Restate observed vs expected behavior. Confirm relevant requirements or docs that define the expectation. Define acceptance criteria for the fix.
+3. **Reproduce & Isolate** — Determine reproducibility (always, intermittent, environment-specific). Capture reproduction steps. List suspected components or modules.
+4. **Analyze Potential Causes** — Brainstorm root causes (data, config, code regressions, external dependencies). Gather supporting evidence (logs, metrics, traces). Highlight unknowns needing investigation.
+5. **Resolve** — Present resolution options (quick fix, refactor, rollback, etc.) with pros/cons and risks. Ask which option to pursue. Summarize chosen approach, pre-work, success criteria, and validation steps.