@veewo/claw-core 0.1.12

package/dist/src/project-check.js

@@ -0,0 +1,238 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ClawError } from "./errors.js";
+import { findProjectRoot, normalizeTaskName } from "./paths.js";
+const DEFAULT_MAX_TASKS_TO_KEEP = 99;
+export function checkProjectProtocol(cwd) {
+    const projectRoot = findRequiredProjectRoot(cwd);
+    const projectJsonPath = path.join(projectRoot, ".claw", "project.json");
+    const { raw, issues } = readRawProjectConfig(projectJsonPath);
+    if (raw !== undefined) {
+        validateProjectConfig(raw, issues);
+    }
+    return {
+        ok: issues.length === 0,
+        projectRoot,
+        projectJsonPath,
+        issues,
+    };
+}
+export function ensureProjectProtocol(cwd) {
+    const projectRoot = findRequiredProjectRoot(cwd);
+    const projectJsonPath = path.join(projectRoot, ".claw", "project.json");
+    const { raw, issues } = readRawProjectConfig(projectJsonPath);
+    if (raw !== undefined) {
+        validateProjectConfig(raw, issues);
+    }
+    const normalized = normalizeProjectConfig(raw, projectRoot);
+    const normalizedText = `${JSON.stringify(normalized, null, 2)}\n`;
+    const previousText = fs.existsSync(projectJsonPath) ? fs.readFileSync(projectJsonPath, "utf-8") : null;
+    const changed = previousText !== normalizedText;
+    if (changed) {
+        fs.mkdirSync(path.dirname(projectJsonPath), { recursive: true });
+        fs.writeFileSync(projectJsonPath, normalizedText, "utf-8");
+    }
+    return {
+        ok: true,
+        changed,
+        projectRoot,
+        projectJsonPath,
+        issueCountBefore: issues.length,
+        issueCountAfter: 0,
+        fixedPaths: collectFixedPaths(issues, changed),
+        issuesBefore: issues,
+        issuesAfter: [],
+        projectConfig: normalized,
+    };
+}
+function findRequiredProjectRoot(cwd) {
+    const projectRoot = findProjectRoot(cwd);
+    if (!projectRoot) {
+        throw new ClawError("CLAW_DIR_NOT_FOUND", `No .claw directory was found from ${cwd}.`, { cwd });
+    }
+    return projectRoot;
+}
+function readRawProjectConfig(projectJsonPath) {
+    if (!fs.existsSync(projectJsonPath)) {
+        return {
+            raw: undefined,
+            issues: [{ path: "project.json", message: "Missing .claw/project.json." }],
+        };
+    }
+    try {
+        return {
+            raw: JSON.parse(fs.readFileSync(projectJsonPath, "utf-8")),
+            issues: [],
+        };
+    }
+    catch (error) {
+        return {
+            raw: undefined,
+            issues: [
+                {
+                    path: "project.json",
+                    message: `Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+        };
+    }
+}
+function normalizeProjectConfig(raw, projectRoot) {
+    const source = asObject(raw);
+    const { autoAchieveTask: _autoAchieveTask, ...sourceWithoutLegacyAutoAchieve } = source ?? {};
+    const sourceMemory = asObject(source?.memory);
+    const sourceGitnexus = asObject(source?.gitnexus);
+    const maxTasksToKeep = source?.maxTasksToKeep;
+    return {
+        ...sourceWithoutLegacyAutoAchieve,
+        id: deriveProjectId(source, projectRoot),
+        name: deriveProjectName(source, projectRoot),
+        maxTasksToKeep: Number.isInteger(maxTasksToKeep) && maxTasksToKeep >= 1
+            ? maxTasksToKeep
+            : DEFAULT_MAX_TASKS_TO_KEEP,
+        externalTruthSkill: normalizeOptionalSkill(source?.externalTruthSkill),
+        externalAdrSkill: normalizeOptionalSkill(source?.externalAdrSkill),
+        contextPaths: normalizeStringArray(source?.contextPaths),
+        memory: {
+            ...sourceMemory,
+            externalDocPaths: normalizeStringArray(sourceMemory?.externalDocPaths),
+        },
+        gitnexus: {
+            ...sourceGitnexus,
+            enabled: typeof sourceGitnexus?.enabled === "boolean" ? sourceGitnexus.enabled : false,
+        },
+    };
+}
+function deriveProjectId(source, projectRoot) {
+    const id = source ? readNonEmptyString(source.id) : undefined;
+    const name = source ? readNonEmptyString(source.name) : undefined;
+    const candidates = [id, name, path.basename(projectRoot)];
+    for (const candidate of candidates) {
+        if (!candidate) {
+            continue;
+        }
+        const normalized = normalizeTaskName(candidate).toLowerCase();
+        if (normalized) {
+            return normalized;
+        }
+    }
+    throw new ClawError("PROJECT_ROOT_NOT_FOUND", "Unable to derive a project id.", { projectRoot });
+}
+function deriveProjectName(source, projectRoot) {
+    return (source ? readNonEmptyString(source.name) : undefined) ?? path.basename(projectRoot);
+}
+function collectFixedPaths(issues, changed) {
+    const paths = new Set(issues.map((issue) => issue.path));
+    if (changed && paths.size === 0) {
+        paths.add("project.json");
+    }
+    return [...paths];
+}
+function validateProjectConfig(raw, issues) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        issues.push({ path: "project.json", message: "project.json must contain a JSON object." });
+        return;
+    }
+    const config = raw;
+    requireString(config, "id", issues);
+    requireString(config, "name", issues);
+    requireIntegerAtLeast(config, "maxTasksToKeep", 1, issues);
+    requireNullableString(config, "externalTruthSkill", issues);
+    requireNullableString(config, "externalAdrSkill", issues);
+    requireStringArray(config, "contextPaths", issues);
+    const memory = requireObject(config, "memory", issues);
+    if (memory) {
+        requireStringArray(memory, "externalDocPaths", issues, "memory.externalDocPaths");
+    }
+    const gitnexus = requireObject(config, "gitnexus", issues);
+    if (gitnexus) {
+        requireBoolean(gitnexus, "enabled", issues, "gitnexus.enabled");
+    }
+}
+function requireString(source, key, issues, label = key) {
+    if (!(key in source)) {
+        issues.push({ path: label, message: "Field is required and must be explicitly present." });
+        return;
+    }
+    if (typeof source[key] !== "string" || !String(source[key]).trim()) {
+        issues.push({ path: label, message: "Field must be a non-empty string." });
+    }
+}
+function requireNullableString(source, key, issues, label = key) {
+    if (!(key in source)) {
+        issues.push({ path: label, message: "Field is required and must be explicitly present." });
+        return;
+    }
+    const value = source[key];
+    if (value !== null && typeof value !== "string") {
+        issues.push({ path: label, message: "Field must be a string or null." });
+    }
+}
+function requireBoolean(source, key, issues, label = key) {
+    if (!(key in source)) {
+        issues.push({ path: label, message: "Field is required and must be explicitly present." });
+        return;
+    }
+    if (typeof source[key] !== "boolean") {
+        issues.push({ path: label, message: "Field must be a boolean." });
+    }
+}
+function requireIntegerAtLeast(source, key, minimum, issues, label = key) {
+    if (!(key in source)) {
+        issues.push({ path: label, message: "Field is required and must be explicitly present." });
+        return;
+    }
+    const value = source[key];
+    if (!Number.isInteger(value) || value < minimum) {
+        issues.push({ path: label, message: `Field must be an integer greater than or equal to ${minimum}.` });
+    }
+}
+function requireStringArray(source, key, issues, label = key) {
+    if (!(key in source)) {
+        issues.push({ path: label, message: "Field is required and must be explicitly present." });
+        return;
+    }
+    const value = source[key];
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+        issues.push({ path: label, message: "Field must be an array of strings." });
+    }
+}
+function requireObject(source, key, issues, label = key) {
+    if (!(key in source)) {
+        issues.push({ path: label, message: "Field is required and must be explicitly present." });
+        return null;
+    }
+    const value = source[key];
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        issues.push({ path: label, message: "Field must be an object." });
+        return null;
+    }
+    return value;
+}
+function asObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function normalizeStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((item) => typeof item === "string");
+}
+function readNonEmptyString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+function normalizeOptionalSkill(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+}
+//# sourceMappingURL=project-check.js.map

package/dist/src/project-check.js.map

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

package/dist/src/requirements-gate.d.ts

@@ -0,0 +1,23 @@
+import type { PlanDocument, PlanReviewResult, PlanReviewer, PlanStatus } from "./types.js";
+export declare const REQUIREMENTS_NEXT_ACTION: "collect_requirements";
+export declare const REQUIREMENTS_INSTRUCTION = "Collect requirements first. Clarify scope if needed, then update goal, rules, references, and tasks before moving to process.active/process.wait/process.discussing.";
+export declare const REVIEW_NEXT_ACTION: "revise_plan_from_review";
+export declare const REVIEW_INSTRUCTION = "Plan review found actionable feedback. Revise goal, rules, references, and tasks using planReview, then move to process.active/process.wait/process.discussing.";
+export declare const REVIEW_ADDRESSED_INSTRUCTION = "Review feedback is considered addressed. Continue with the selected process status.";
+export declare function runPlanReview(params: {
+    reviewer?: PlanReviewer;
+    planContent: PlanDocument;
+    previousStatus?: PlanStatus;
+    targetStatus: PlanStatus;
+    workflowDefinitions?: string;
+    projectId?: string;
+    taskName?: string;
+}): Promise<{
+    nextStatus: PlanStatus;
+    planReview?: PlanReviewResult;
+    nextAction?: "revise_plan_from_review" | "proceed";
+    instruction?: string;
+}>;
+export declare function shouldRunRequirementsExitReview(previousStatus: PlanStatus | undefined, targetStatus: PlanStatus): boolean;
+export declare function hasActionableReviewFeedback(review: PlanReviewResult): boolean;
+export declare function isProcessStatus(status: PlanStatus): boolean;

package/dist/src/requirements-gate.js

@@ -0,0 +1,49 @@
+export const REQUIREMENTS_NEXT_ACTION = "collect_requirements";
+export const REQUIREMENTS_INSTRUCTION = "Collect requirements first. Clarify scope if needed, then update goal, rules, references, and tasks before moving to process.active/process.wait/process.discussing.";
+export const REVIEW_NEXT_ACTION = "revise_plan_from_review";
+export const REVIEW_INSTRUCTION = "Plan review found actionable feedback. Revise goal, rules, references, and tasks using planReview, then move to process.active/process.wait/process.discussing.";
+export const REVIEW_ADDRESSED_INSTRUCTION = "Review feedback is considered addressed. Continue with the selected process status.";
+export async function runPlanReview(params) {
+    if (!params.reviewer) {
+        return { nextStatus: params.targetStatus };
+    }
+    if (!shouldRunRequirementsExitReview(params.previousStatus, params.targetStatus)) {
+        return { nextStatus: params.targetStatus };
+    }
+    const review = await params.reviewer({
+        planContent: params.planContent,
+        isSubPlan: Boolean(params.planContent.parentPlan || params.planContent.parentTaskId),
+        workflowDefinitions: params.workflowDefinitions,
+        projectId: params.projectId,
+        taskName: params.taskName,
+    });
+    if (!review || !hasActionableReviewFeedback(review)) {
+        return {
+            nextStatus: params.targetStatus,
+            ...(review ? { planReview: review, nextAction: "proceed" } : {}),
+            ...(review ? { instruction: REVIEW_ADDRESSED_INSTRUCTION } : {}),
+        };
+    }
+    return {
+        nextStatus: "prepare.review",
+        planReview: review,
+        nextAction: "revise_plan_from_review",
+        instruction: REVIEW_INSTRUCTION,
+    };
+}
+export function shouldRunRequirementsExitReview(previousStatus, targetStatus) {
+    if (!isProcessStatus(targetStatus)) {
+        return false;
+    }
+    if (!previousStatus) {
+        return true;
+    }
+    return previousStatus === "prepare.requirements";
+}
+export function hasActionableReviewFeedback(review) {
+    return review.issues.length > 0 || review.suggestions.length > 0;
+}
+export function isProcessStatus(status) {
+    return status.startsWith("process.");
+}
+//# sourceMappingURL=requirements-gate.js.map

package/dist/src/requirements-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements-gate.js","sourceRoot":"","sources":["../../src/requirements-gate.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAA+B,CAAC;AACxE,MAAM,CAAC,MAAM,wBAAwB,GACnC,sKAAsK,CAAC;AACzK,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAkC,CAAC;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAC7B,iKAAiK,CAAC;AACpK,MAAM,CAAC,MAAM,4BAA4B,GACvC,qFAAqF,CAAC;AAExF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAQnC;IAMC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,+BAA+B,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACjF,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;QACnC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,IAAI,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC;QACpF,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;QAC/C,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;KACA,CAAC,CAAC;IAE7B,IAAI,CAAC,MAAM,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC,EAAE,CAAC;QACpD,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,YAAY;YAC/B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,SAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,UAAU,EAAE,gBAAgB;QAC5B,UAAU,EAAE,MAAM;QAClB,UAAU,EAAE,yBAAyB;QACrC,WAAW,EAAE,kBAAkB;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,cAAsC,EACtC,YAAwB;IAExB,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,cAAc,KAAK,sBAAsB,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAAwB;IAClE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,OAAO,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC"}

package/dist/src/switch-task.d.ts

@@ -0,0 +1,2 @@
+import type { SwitchTaskInput, SwitchTaskResult } from "./types.js";
+export declare function switchTask(input: SwitchTaskInput): SwitchTaskResult;

package/dist/src/switch-task.js

@@ -0,0 +1,60 @@
+import { ensureTaskMeta, resolveProjectContext, resolveTaskContext, saveTaskMeta } from "./context.js";
+export function switchTask(input) {
+    const project = resolveProjectContext(input.cwd);
+    const source = resolveTaskContext(project, input.fromTask);
+    const target = ensureTaskMeta(project, input.toTask);
+    const now = new Date().toISOString();
+    const sourceSnapshot = {
+        projectId: project.projectId,
+        task: source.taskName,
+        status: source.meta.status,
+        updatedAt: source.meta.updatedAt,
+        activePlan: source.meta.activePlan,
+        planPath: source.activePlanPath,
+    };
+    const leaveState = {
+        leftAt: now,
+        updatedAt: now,
+        reason: input.reason ?? "user_switch",
+        fromTask: source.taskName,
+        toTask: target.taskName,
+        nextTask: target.taskName,
+        continueNeeded: input.reason !== "completed" && input.reason !== "abandoned",
+        sourceSnapshot,
+    };
+    const inheritedFrom = {
+        projectId: project.projectId,
+        task: source.taskName,
+        mode: input.mode ?? "prev_task",
+        linkedAt: now,
+        historyLimit: input.historyLimit ?? 5,
+        sourceSnapshot,
+        reason: leaveState.reason,
+        sourceStatus: source.meta.status ?? "active",
+        sourceUpdatedAt: source.meta.updatedAt,
+        sourceLeaveStateUpdatedAt: leaveState.updatedAt ?? leaveState.leftAt,
+        sourceLeaveState: leaveState,
+    };
+    source.meta.leaveState = leaveState;
+    source.meta.updatedAt = now;
+    target.meta.prevTask = source.taskName;
+    target.meta.previousTask = {
+        projectId: project.projectId,
+        task: source.taskName,
+        linkedAt: now,
+        reason: leaveState.reason,
+        leaveStateAt: leaveState.leftAt,
+    };
+    target.meta.inheritedFrom = inheritedFrom;
+    target.meta.updatedAt = now;
+    saveTaskMeta(source);
+    saveTaskMeta(target);
+    return {
+        fromTask: source.taskName,
+        toTask: target.taskName,
+        sourceMetaPath: source.metaPath,
+        targetMetaPath: target.metaPath,
+        leaveState,
+    };
+}
+//# sourceMappingURL=switch-task.js.map

package/dist/src/switch-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch-task.js","sourceRoot":"","sources":["../../src/switch-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGvG,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,MAAM,cAAc,GAAuB;QACzC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;QAC1B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS;QAChC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU;QAClC,QAAQ,EAAE,MAAM,CAAC,cAAc;KAChC,CAAC;IAEF,MAAM,UAAU,GAAe;QAC7B,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,GAAG;QACd,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,aAAa;QACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,QAAQ;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,cAAc,EAAE,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;QAC5E,cAAc;KACf,CAAC;IAEF,MAAM,aAAa,GAAkB;QACnC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,WAAW;QAC/B,QAAQ,EAAE,GAAG;QACb,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;QACrC,cAAc;QACd,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ;QAC5C,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS;QACtC,yBAAyB,EAAE,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,MAAM;QACpE,gBAAgB,EAAE,UAAU;KAC7B,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACpC,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;IAC5B,MAAM,CAAC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACvC,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG;QACzB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,QAAQ,EAAE,GAAG;QACb,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,YAAY,EAAE,UAAU,CAAC,MAAM;KAChC,CAAC;IACF,MAAM,CAAC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IAC1C,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;IAE5B,YAAY,CAAC,MAAM,CAAC,CAAC;IACrB,YAAY,CAAC,MAAM,CAAC,CAAC;IAErB,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,QAAQ;QACvB,cAAc,EAAE,MAAM,CAAC,QAAQ;QAC/B,cAAc,EAAE,MAAM,CAAC,QAAQ;QAC/B,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/src/task-retention.d.ts

@@ -0,0 +1,2 @@
+import type { ProjectContext, TaskRetentionResult } from "./types.js";
+export declare function enforceTaskRetention(project: ProjectContext, currentTaskName?: string): TaskRetentionResult;

package/dist/src/task-retention.js

@@ -0,0 +1,126 @@
+import fs from "node:fs";
+import path from "node:path";
+import { readJsonFile } from "./io.js";
+export function enforceTaskRetention(project, currentTaskName) {
+    const maxTasksToKeep = project.projectConfig?.maxTasksToKeep ?? 99;
+    const archiveTasksRoot = path.join(project.clawDir, "archive", "tasks");
+    const prunedArchivedTasks = [];
+    let archivedCurrentTask;
+    for (const taskName of listActiveTaskNames(project)) {
+        const archivedTask = archiveTaskDirectory(project, taskName, archiveTasksRoot);
+        if (archivedTask && taskName === currentTaskName) {
+            archivedCurrentTask = archivedTask;
+        }
+    }
+    const archivedTasks = listArchivedTasks(archiveTasksRoot);
+    if (archivedTasks.length > maxTasksToKeep) {
+        const overflow = archivedTasks.length - maxTasksToKeep;
+        const toPrune = archivedTasks
+            .sort(compareArchivedTasksByUpdatedAt)
+            .slice(0, overflow);
+        for (const archivedTask of toPrune) {
+            fs.rmSync(archivedTask.archivedTaskDir, { recursive: true, force: true });
+            prunedArchivedTasks.push(archivedTask);
+        }
+    }
+    return {
+        enabled: true,
+        maxTasksToKeep,
+        ...(archivedCurrentTask ? { archivedCurrentTask } : {}),
+        prunedArchivedTasks,
+    };
+}
+function archiveTaskDirectory(project, taskName, archiveTasksRoot) {
+    const sourceTaskDir = path.join(project.tasksDir, taskName);
+    if (!fs.existsSync(sourceTaskDir) || !fs.statSync(sourceTaskDir).isDirectory()) {
+        return undefined;
+    }
+    const metaPath = path.join(sourceTaskDir, "meta.json");
+    if (!fs.existsSync(metaPath)) {
+        return undefined;
+    }
+    const meta = readJsonFile(metaPath);
+    const activePlanPath = typeof meta.activePlan === "string" ? path.join(sourceTaskDir, meta.activePlan) : undefined;
+    const planStatus = activePlanPath && fs.existsSync(activePlanPath)
+        ? readJsonFile(activePlanPath).status
+        : undefined;
+    if (meta.status !== "completed" && planStatus !== "end.completed") {
+        return undefined;
+    }
+    fs.mkdirSync(archiveTasksRoot, { recursive: true });
+    const archivedTaskDir = uniqueArchiveTaskDir(archiveTasksRoot, taskName);
+    fs.renameSync(sourceTaskDir, archivedTaskDir);
+    const archivedPlanPath = typeof meta.activePlan === "string" ? path.join(archivedTaskDir, meta.activePlan) : undefined;
+    return {
+        taskName,
+        sourceTaskDir,
+        archivedTaskDir,
+        ...(archivedPlanPath ? { archivedPlanPath } : {}),
+        ...(meta.updatedAt ? { updatedAt: meta.updatedAt } : {}),
+    };
+}
+function listActiveTaskNames(project) {
+    if (!fs.existsSync(project.tasksDir)) {
+        return [];
+    }
+    return fs
+        .readdirSync(project.tasksDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name);
+}
+function listArchivedTasks(archiveTasksRoot) {
+    if (!fs.existsSync(archiveTasksRoot)) {
+        return [];
+    }
+    const entries = [];
+    for (const child of fs.readdirSync(archiveTasksRoot, { withFileTypes: true })) {
+        if (!child.isDirectory()) {
+            continue;
+        }
+        const archivedTaskDir = path.join(archiveTasksRoot, child.name);
+        const metaPath = path.join(archivedTaskDir, "meta.json");
+        let updatedAt;
+        let taskName = child.name;
+        let archivedPlanPath;
+        if (fs.existsSync(metaPath)) {
+            const meta = readJsonFile(metaPath);
+            updatedAt = meta.updatedAt;
+            taskName = typeof meta.name === "string" && meta.name.trim() ? meta.name : child.name;
+            if (typeof meta.activePlan === "string" && meta.activePlan.trim()) {
+                archivedPlanPath = path.join(archivedTaskDir, meta.activePlan);
+            }
+        }
+        entries.push({
+            taskName,
+            sourceTaskDir: "",
+            archivedTaskDir,
+            ...(archivedPlanPath ? { archivedPlanPath } : {}),
+            ...(updatedAt ? { updatedAt } : {}),
+        });
+    }
+    return entries;
+}
+function compareArchivedTasksByUpdatedAt(left, right) {
+    const leftTime = left.updatedAt ? Date.parse(left.updatedAt) : Number.NEGATIVE_INFINITY;
+    const rightTime = right.updatedAt ? Date.parse(right.updatedAt) : Number.NEGATIVE_INFINITY;
+    if (leftTime !== rightTime) {
+        return leftTime - rightTime;
+    }
+    return left.taskName.localeCompare(right.taskName);
+}
+function uniqueArchiveTaskDir(archiveTasksRoot, taskName) {
+    const candidate = path.join(archiveTasksRoot, taskName);
+    if (!fs.existsSync(candidate)) {
+        return candidate;
+    }
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    let attempt = 1;
+    while (true) {
+        const suffixed = path.join(archiveTasksRoot, `${taskName}--${stamp}-${attempt}`);
+        if (!fs.existsSync(suffixed)) {
+            return suffixed;
+        }
+        attempt += 1;
+    }
+}
+//# sourceMappingURL=task-retention.js.map

package/dist/src/task-retention.js.map

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

package/dist/src/truth.d.ts

@@ -0,0 +1,2 @@
+import type { TruthIngestInput, TruthIngestResult } from "./types.js";
+export declare function ingestTruth(input: TruthIngestInput): TruthIngestResult;

package/dist/src/truth.js

@@ -0,0 +1,33 @@
+import { resolveProjectContext } from "./context.js";
+import { ClawError } from "./errors.js";
+import { readTextFile, writeTextFile } from "./io.js";
+import { ensureInsideDir } from "./paths.js";
+export function ingestTruth(input) {
+    const project = resolveProjectContext(input.cwd);
+    const targetPath = ensureInsideDir(project.truthDir, input.target.replace(/\\/g, "/"));
+    if (!targetPath) {
+        throw new ClawError("TRUTH_TARGET_INVALID", `Truth target "${input.target}" escapes .claw/truth/.`, {
+            target: input.target,
+        });
+    }
+    const nextContent = input.append && exists(targetPath)
+        ? `${readTextFile(targetPath)}${input.content}`
+        : input.content;
+    writeTextFile(targetPath, nextContent);
+    return {
+        truthRoot: project.truthDir,
+        targetPath,
+        bytesWritten: Buffer.byteLength(nextContent, "utf-8"),
+        mode: input.append ? "append" : "replace",
+    };
+}
+function exists(filePath) {
+    try {
+        readTextFile(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=truth.js.map

package/dist/src/truth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truth.js","sourceRoot":"","sources":["../../src/truth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACvF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,SAAS,CAAC,sBAAsB,EAAE,iBAAiB,KAAK,CAAC,MAAM,yBAAyB,EAAE;YAClG,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC;QACpD,CAAC,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE;QAC/C,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IAClB,aAAa,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAEvC,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,QAAQ;QAC3B,UAAU;QACV,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC;QACrD,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,QAAgB;IAC9B,IAAI,CAAC;QACH,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}