ridgeline 0.4.4 → 0.5.7

package/dist/stores/state.js

@@ -0,0 +1,264 @@
+"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.rewindTo = exports.getNextPipelineStage = exports.markBuildRunning = exports.advancePipeline = exports.getPipelineStatus = exports.getNextIncompletePhase = exports.resetRetries = exports.updatePhaseStatus = exports.initState = exports.saveState = exports.loadState = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const tags_1 = require("./tags");
+const statePath = (buildDir) => path.join(buildDir, "state.json");
+const DEFAULT_PIPELINE = {
+    shape: "pending",
+    spec: "pending",
+    plan: "pending",
+    build: "pending",
+};
+const loadState = (buildDir) => {
+    const fp = statePath(buildDir);
+    if (fs.existsSync(fp)) {
+        const state = JSON.parse(fs.readFileSync(fp, "utf-8"));
+        // Backfill pipeline for legacy state files
+        if (!state.pipeline) {
+            state.pipeline = derivePipelineFromArtifacts(buildDir);
+        }
+        return state;
+    }
+    return null;
+};
+exports.loadState = loadState;
+const saveState = (buildDir, state) => {
+    fs.writeFileSync(statePath(buildDir), JSON.stringify(state, null, 2) + "\n");
+};
+exports.saveState = saveState;
+const initState = (buildName, phases) => ({
+    buildName,
+    startedAt: new Date().toISOString(),
+    pipeline: { ...DEFAULT_PIPELINE },
+    phases: phases.map((p) => ({
+        id: p.id,
+        status: "pending",
+        checkpointTag: (0, tags_1.checkpointTagName)(buildName, p.id),
+        completionTag: null,
+        retries: 0,
+        duration: null,
+        completedAt: null,
+        failedAt: null,
+    })),
+});
+exports.initState = initState;
+const updatePhaseStatus = (buildDir, state, phaseId, update) => {
+    const phase = state.phases.find((p) => p.id === phaseId);
+    if (phase) {
+        Object.assign(phase, update);
+        (0, exports.saveState)(buildDir, state);
+    }
+};
+exports.updatePhaseStatus = updatePhaseStatus;
+const resetRetries = (buildDir, state) => {
+    for (const phase of state.phases) {
+        if (phase.status !== "complete") {
+            phase.retries = 0;
+            phase.status = "pending";
+            phase.failedAt = null;
+        }
+    }
+    (0, exports.saveState)(buildDir, state);
+};
+exports.resetRetries = resetRetries;
+const getNextIncompletePhase = (state, cwd) => {
+    for (const phase of state.phases) {
+        if (phase.status === "complete") {
+            // Verify the completion tag still exists
+            if (!(0, tags_1.verifyCompletionTag)(state.buildName, phase.id, cwd)) {
+                // Tag was deleted — treat as incomplete
+                phase.status = "pending";
+                phase.completionTag = null;
+                return phase;
+            }
+            continue;
+        }
+        return phase;
+    }
+    return null;
+};
+exports.getNextIncompletePhase = getNextIncompletePhase;
+// ---------------------------------------------------------------------------
+// Pipeline state helpers
+// ---------------------------------------------------------------------------
+/** Derive pipeline state from existing artifacts on disk (for legacy state files). */
+const derivePipelineFromArtifacts = (buildDir) => {
+    const hasShape = fs.existsSync(path.join(buildDir, "shape.md"));
+    const hasSpec = fs.existsSync(path.join(buildDir, "spec.md"));
+    const hasConstraints = fs.existsSync(path.join(buildDir, "constraints.md"));
+    const phasesDir = path.join(buildDir, "phases");
+    const hasPhases = fs.existsSync(phasesDir) &&
+        fs.readdirSync(phasesDir).some((f) => f.endsWith(".md") && /^\d+-.+\.md$/.test(f));
+    return {
+        shape: hasShape ? "complete" : "pending",
+        spec: hasSpec && hasConstraints ? "complete" : "pending",
+        plan: hasPhases ? "complete" : "pending",
+        build: "pending",
+    };
+};
+/** Get pipeline status, verifying against both state.json and file existence. */
+const getPipelineStatus = (buildDir) => {
+    const state = (0, exports.loadState)(buildDir);
+    const fromState = state?.pipeline ?? { ...DEFAULT_PIPELINE };
+    const fromDisk = derivePipelineFromArtifacts(buildDir);
+    // Belt and suspenders: if state says complete but file is missing, trust disk
+    return {
+        shape: fromState.shape === "complete" && fromDisk.shape === "complete" ? "complete" : fromDisk.shape,
+        spec: fromState.spec === "complete" && fromDisk.spec === "complete" ? "complete" : fromDisk.spec,
+        plan: fromState.plan === "complete" && fromDisk.plan === "complete" ? "complete" : fromDisk.plan,
+        build: fromState.build === "pending" ? "pending" : fromState.build,
+    };
+};
+exports.getPipelineStatus = getPipelineStatus;
+/** Mark a pipeline stage as complete and persist. */
+const advancePipeline = (buildDir, buildName, stage) => {
+    let state = (0, exports.loadState)(buildDir);
+    if (!state) {
+        state = {
+            buildName,
+            startedAt: new Date().toISOString(),
+            pipeline: { ...DEFAULT_PIPELINE },
+            phases: [],
+        };
+    }
+    if (stage === "build") {
+        state.pipeline.build = "complete";
+    }
+    else {
+        state.pipeline[stage] = "complete";
+    }
+    (0, exports.saveState)(buildDir, state);
+};
+exports.advancePipeline = advancePipeline;
+/** Set build pipeline stage to "running". */
+const markBuildRunning = (buildDir, buildName) => {
+    let state = (0, exports.loadState)(buildDir);
+    if (!state) {
+        state = {
+            buildName,
+            startedAt: new Date().toISOString(),
+            pipeline: { ...DEFAULT_PIPELINE },
+            phases: [],
+        };
+    }
+    state.pipeline.build = "running";
+    (0, exports.saveState)(buildDir, state);
+};
+exports.markBuildRunning = markBuildRunning;
+const PIPELINE_STAGES = ["shape", "spec", "plan", "build"];
+/** Determine the next incomplete pipeline stage. */
+const getNextPipelineStage = (buildDir) => {
+    const status = (0, exports.getPipelineStatus)(buildDir);
+    for (const stage of PIPELINE_STAGES) {
+        const s = status[stage];
+        if (s === "pending" || s === "running")
+            return stage;
+    }
+    return null;
+};
+exports.getNextPipelineStage = getNextPipelineStage;
+/** Collect files to delete when resetting a single stage. */
+const collectStageFiles = (buildDir, stage) => {
+    const files = [];
+    const phasesDir = path.join(buildDir, "phases");
+    switch (stage) {
+        case "spec":
+            for (const f of ["spec.md", "constraints.md", "taste.md"]) {
+                const fp = path.join(buildDir, f);
+                if (fs.existsSync(fp))
+                    files.push(fp);
+            }
+            break;
+        case "plan":
+            if (fs.existsSync(phasesDir)) {
+                for (const f of fs.readdirSync(phasesDir))
+                    files.push(path.join(phasesDir, f));
+            }
+            break;
+        case "build": {
+            const handoff = path.join(buildDir, "handoff.md");
+            if (fs.existsSync(handoff))
+                files.push(handoff);
+            if (fs.existsSync(phasesDir)) {
+                for (const f of fs.readdirSync(phasesDir)) {
+                    if (f.includes("feedback"))
+                        files.push(path.join(phasesDir, f));
+                }
+            }
+            break;
+        }
+    }
+    return files;
+};
+/** Reset pipeline state for stages downstream of targetStage. */
+const resetPipelineState = (buildDir, buildName, targetStage, resetStages) => {
+    const state = (0, exports.loadState)(buildDir);
+    if (!state)
+        return;
+    const targetIndex = PIPELINE_STAGES.indexOf(targetStage);
+    for (const stage of PIPELINE_STAGES) {
+        if (PIPELINE_STAGES.indexOf(stage) > targetIndex) {
+            state.pipeline[stage] = "pending";
+        }
+    }
+    if (targetStage === "build") {
+        state.pipeline.build = "pending";
+    }
+    else {
+        state.pipeline[targetStage] = "complete";
+    }
+    if (resetStages.includes("plan") || resetStages.includes("build")) {
+        state.phases = [];
+    }
+    if (resetStages.includes("build")) {
+        (0, tags_1.cleanupBuildTags)(buildName);
+    }
+    (0, exports.saveState)(buildDir, state);
+};
+/**
+ * Rewind to a given stage: mark downstream stages as pending,
+ * return list of files/dirs to delete from disk.
+ */
+const rewindTo = (buildDir, buildName, targetStage) => {
+    const resetStages = PIPELINE_STAGES.slice(PIPELINE_STAGES.indexOf(targetStage) + 1);
+    const toDelete = resetStages.flatMap((stage) => collectStageFiles(buildDir, stage));
+    resetPipelineState(buildDir, buildName, targetStage, resetStages);
+    return toDelete;
+};
+exports.rewindTo = rewindTo;
+//# sourceMappingURL=state.js.map

package/dist/stores/state.js.map

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

package/dist/stores/tags.d.ts

@@ -0,0 +1,6 @@
+export declare const checkpointTagName: (buildName: string, phaseId: string) => string;
+export declare const completionTagName: (buildName: string, phaseId: string) => string;
+export declare const createCheckpoint: (checkpointTag: string, phaseId: string, cwd?: string) => void;
+export declare const createCompletionTag: (buildName: string, phaseId: string, cwd?: string) => string;
+export declare const verifyCompletionTag: (buildName: string, phaseId: string, cwd?: string) => boolean;
+export declare const cleanupBuildTags: (buildName: string, cwd?: string) => void;

package/dist/stores/tags.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanupBuildTags = exports.verifyCompletionTag = exports.createCompletionTag = exports.createCheckpoint = exports.completionTagName = exports.checkpointTagName = void 0;
+const git_1 = require("../git");
+const checkpointTagName = (buildName, phaseId) => `ridgeline/checkpoint/${buildName}/${phaseId}`;
+exports.checkpointTagName = checkpointTagName;
+const completionTagName = (buildName, phaseId) => `ridgeline/phase/${buildName}/${phaseId}`;
+exports.completionTagName = completionTagName;
+// Commit dirty working tree and create a checkpoint tag
+const createCheckpoint = (checkpointTag, phaseId, cwd) => {
+    if ((0, git_1.isWorkingTreeDirty)(cwd)) {
+        (0, git_1.commitAll)(`chore: pre-phase checkpoint for ${phaseId}`, cwd);
+    }
+    (0, git_1.createTag)(checkpointTag, cwd, true);
+};
+exports.createCheckpoint = createCheckpoint;
+// Create a completion tag for a phase and return the tag name
+const createCompletionTag = (buildName, phaseId, cwd) => {
+    const tag = (0, exports.completionTagName)(buildName, phaseId);
+    (0, git_1.createTag)(tag, cwd, true);
+    return tag;
+};
+exports.createCompletionTag = createCompletionTag;
+// Verify that a phase's completion tag exists in git
+const verifyCompletionTag = (buildName, phaseId, cwd) => (0, git_1.tagExists)((0, exports.completionTagName)(buildName, phaseId), cwd);
+exports.verifyCompletionTag = verifyCompletionTag;
+// Delete all ridgeline tags for a build
+const cleanupBuildTags = (buildName, cwd) => {
+    (0, git_1.deleteTagsByPrefix)(`ridgeline/${buildName}/`, cwd);
+    (0, git_1.deleteTagsByPrefix)(`ridgeline/checkpoint/${buildName}/`, cwd);
+    (0, git_1.deleteTagsByPrefix)(`ridgeline/phase/${buildName}/`, cwd);
+};
+exports.cleanupBuildTags = cleanupBuildTags;
+//# sourceMappingURL=tags.js.map

package/dist/stores/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../src/stores/tags.ts"],"names":[],"mappings":";;;AAAA,gCAAgG;AAEzF,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAE,OAAe,EAAU,EAAE,CAC9E,wBAAwB,SAAS,IAAI,OAAO,EAAE,CAAA;AADnC,QAAA,iBAAiB,qBACkB;AAEzC,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAE,OAAe,EAAU,EAAE,CAC9E,mBAAmB,SAAS,IAAI,OAAO,EAAE,CAAA;AAD9B,QAAA,iBAAiB,qBACa;AAE3C,wDAAwD;AACjD,MAAM,gBAAgB,GAAG,CAAC,aAAqB,EAAE,OAAe,EAAE,GAAY,EAAQ,EAAE;IAC7F,IAAI,IAAA,wBAAkB,EAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAA,eAAS,EAAC,mCAAmC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAA;IAC9D,CAAC;IACD,IAAA,eAAS,EAAC,aAAa,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;AACrC,CAAC,CAAA;AALY,QAAA,gBAAgB,oBAK5B;AAED,8DAA8D;AACvD,MAAM,mBAAmB,GAAG,CAAC,SAAiB,EAAE,OAAe,EAAE,GAAY,EAAU,EAAE;IAC9F,MAAM,GAAG,GAAG,IAAA,yBAAiB,EAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACjD,IAAA,eAAS,EAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IACzB,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAJY,QAAA,mBAAmB,uBAI/B;AAED,qDAAqD;AAC9C,MAAM,mBAAmB,GAAG,CAAC,SAAiB,EAAE,OAAe,EAAE,GAAY,EAAW,EAAE,CAC/F,IAAA,eAAS,EAAC,IAAA,yBAAiB,EAAC,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,CAAA;AAD1C,QAAA,mBAAmB,uBACuB;AAEvD,wCAAwC;AACjC,MAAM,gBAAgB,GAAG,CAAC,SAAiB,EAAE,GAAY,EAAQ,EAAE;IACxE,IAAA,wBAAkB,EAAC,aAAa,SAAS,GAAG,EAAE,GAAG,CAAC,CAAA;IAClD,IAAA,wBAAkB,EAAC,wBAAwB,SAAS,GAAG,EAAE,GAAG,CAAC,CAAA;IAC7D,IAAA,wBAAkB,EAAC,mBAAmB,SAAS,GAAG,EAAE,GAAG,CAAC,CAAA;AAC1D,CAAC,CAAA;AAJY,QAAA,gBAAgB,oBAI5B"}

package/dist/stores/trajectory.d.ts

@@ -0,0 +1,11 @@
+import { TrajectoryEntry } from "../types";
+export declare const logTrajectory: (buildDir: string, entry: TrajectoryEntry) => void;
+export declare const makeTrajectoryEntry: (type: TrajectoryEntry["type"], phaseId: string | null, summary: string, opts?: {
+    duration?: number;
+    tokens?: {
+        input: number;
+        output: number;
+    };
+    costUsd?: number;
+}) => TrajectoryEntry;
+export declare const readTrajectory: (buildDir: string) => TrajectoryEntry[];

package/dist/stores/trajectory.js

@@ -0,0 +1,66 @@
+"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.readTrajectory = exports.makeTrajectoryEntry = exports.logTrajectory = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const trajectoryPath = (buildDir) => path.join(buildDir, "trajectory.jsonl");
+const logTrajectory = (buildDir, entry) => {
+    fs.appendFileSync(trajectoryPath(buildDir), JSON.stringify(entry) + "\n");
+};
+exports.logTrajectory = logTrajectory;
+const makeTrajectoryEntry = (type, phaseId, summary, opts) => ({
+    timestamp: new Date().toISOString(),
+    type,
+    phaseId,
+    duration: opts?.duration ?? null,
+    tokens: opts?.tokens ?? null,
+    costUsd: opts?.costUsd ?? null,
+    summary,
+});
+exports.makeTrajectoryEntry = makeTrajectoryEntry;
+// Read all trajectory entries from the JSONL file
+const readTrajectory = (buildDir) => {
+    const fp = trajectoryPath(buildDir);
+    if (!fs.existsSync(fp))
+        return [];
+    return fs.readFileSync(fp, "utf-8")
+        .trim()
+        .split("\n")
+        .filter((line) => line.length > 0)
+        .map((line) => JSON.parse(line));
+};
+exports.readTrajectory = readTrajectory;
+//# sourceMappingURL=trajectory.js.map

package/dist/stores/trajectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.js","sourceRoot":"","sources":["../../src/stores/trajectory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAC7B,gDAAiC;AAGjC,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAU,EAAE,CAClD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAA;AAElC,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAE,KAAsB,EAAQ,EAAE;IAC9E,EAAE,CAAC,cAAc,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;AAC3E,CAAC,CAAA;AAFY,QAAA,aAAa,iBAEzB;AAEM,MAAM,mBAAmB,GAAG,CACjC,IAA6B,EAC7B,OAAsB,EACtB,OAAe,EACf,IAIC,EACgB,EAAE,CAAC,CAAC;IACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACnC,IAAI;IACJ,OAAO;IACP,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI;IAChC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI;IAC5B,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;IAC9B,OAAO;CACR,CAAC,CAAA;AAjBW,QAAA,mBAAmB,uBAiB9B;AAEF,kDAAkD;AAC3C,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAqB,EAAE;IACpE,MAAM,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,CAAA;IACjC,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC;SAChC,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC,CAAA;AACvD,CAAC,CAAA;AARY,QAAA,cAAc,kBAQ1B"}

package/dist/types.d.ts

@@ -15,8 +15,8 @@ export type RidgelineConfig = {
     unsafe: boolean;
     networkAllowlist: string[];
     sandboxProvider?: import("./engine/claude/sandbox").SandboxProvider | null;
-    worktreePath: string | null;
     extraContext: string | null;
+    flavour: string | null;
 };
 export type PhaseInfo = {
     id: string;
@@ -30,7 +30,6 @@ export type PhaseState = {
     status: "pending" | "building" | "reviewing" | "complete" | "failed";
     checkpointTag: string;
     completionTag: string | null;
-    isMerged: boolean;
     retries: number;
     duration: number | null;
     completedAt: string | null;

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "ridgeline",
-  "version": "0.4.4",
+  "version": "0.5.7",
   "description": "Build harness for long-horizon software execution",
   "license": "MIT",
   "bin": {
     "ridgeline": "dist/cli.js"
   },
   "scripts": {
-    "build": "tsc && rm -rf dist/agents && cp -r src/agents dist/agents",
+    "build": "tsc && rm -rf dist/agents && cp -r src/agents dist/agents && rm -rf dist/flavours && cp -r src/flavours dist/flavours",
     "dev": "tsc --watch",
     "lint": "npm run lint:code && npm run lint:markdown && npm run lint:agents && npm run lint:fallow",
     "lint:code": "oxlint --ignore-pattern examples",