@entelligentsia/forgecli 1.0.3 → 1.0.14

package/dist/forge-payload/.base-pack/workflows/run_sprint.md

@@ -1,225 +0,0 @@
----
-audience: orchestrator-only
-deps:
-  personas: [orchestrator]
----
-
-# Workflow: Run Sprint (Forge)
-
-## Purpose
-
-Drive all tasks in a sprint through the pipeline. Respects dependency
-ordering and execution mode. Handles errors without halting the whole
-sprint — escalated or failed tasks do not block unrelated tasks.
-
----
-
-## Step 1 — Load Sprint
-
-- Read `.forge/store/sprints/{{PREFIX}}-S{NN}.json`
-- Read all task JSONs from `.forge/store/tasks/` filtered by `sprintId`
-
-**Skip** tasks already in a terminal status: `committed`, `abandoned`.
-**Resume** tasks mid-pipeline: `planned`, `plan-approved`, `implementing`, `review-approved`, `approved`, `escalated` (only if explicitly requested).
-
-Update sprint `status` to `active`.
-
-## Step 2 — Sort by Dependency
-
-- Topological sort: tasks with no remaining dependencies go first.
-- Compute waves: tasks with no inter-wave edges can run in parallel.
-- Validate: no cycles. If a cycle is detected, stop and escalate to the user.
-
-### Wave Computation Algorithm
-
-```python
-function compute_waves(tasks):
-    # Build adjacency list from task.dependencies
-    graph = {task_id: set() for task_id in tasks}
-    in_degree = {task_id: 0 for task_id in tasks}
-    task_map = {task.taskId: task for task in tasks}
-
-    for task in tasks:
-        for dep_id in task.get("dependencies", []):
-            if dep_id in graph:
-                graph[dep_id].add(task.taskId)
-                in_degree[task.taskId] += 1
-
-    # Kahn's algorithm — each "wave" is all nodes with in_degree == 0
-    waves = []
-    queue = [tid for tid, deg in in_degree.items() if deg == 0]
-
-    while queue:
-        wave = sorted(queue)   # deterministic ordering within a wave
-        waves.append(wave)
-        next_queue = []
-        for tid in wave:
-            for successor in graph[tid]:
-                in_degree[successor] -= 1
-                if in_degree[successor] == 0:
-                    next_queue.append(successor)
-        queue = next_queue
-
-    # If any nodes remain, there is a cycle
-    remaining = [tid for tid, deg in in_degree.items() if deg > 0]
-    if remaining:
-        raise CycleError(f"Dependency cycle detected among: {remaining}")
-
-    return waves
-```
-
-## Step 3 — Execute
-
-### Clear Progress Log at Sprint Start
-
-Before dispatching any task, clear the progress log for this sprint:
-
-```bash
-FORGE_ROOT=$(node -e "console.log(require('./.forge/config.json').paths.forgeRoot)")
-node "$FORGE_ROOT/tools/store-cli.cjs" progress-clear {SPRINT_ID}
-```
-
-This ensures a clean log for each sprint run.
-
-### Sequential Mode (default)
-
-```python
-for each task in dependency_sorted(tasks):
-  # Announce with the orchestrator banner
-  print("🌊 Sprint {SPRINT_ID} — running {task.taskId}")
-
-  # Spawn a fresh-context subagent for the full task pipeline via the Agent tool.
-  # The task-level orchestrator then spawns per-phase subagents with their own
-  # per-phase model resolution (see orchestrate_task.md).
-  spawn_subagent(
-    prompt="Read `.forge/workflows/orchestrate_task.md` and follow it. "
-           "Task ID: {task.taskId}. "
-           "Also read `engineering/MASTER_INDEX.md` for project state.",
-    description="Run pipeline for {task.taskId}",
-    model="sonnet"    # orchestrator is a lightweight state machine
-  )
-
-  # After the subagent returns, read the task status from disk.
-  task_status = read_task_status(task.taskId)   # .forge/store/tasks/{TASK_ID}.json
-
-  # Re-spawn guard: if the subagent returned without reaching a terminal state
-  # (e.g. it produced large output and ran out of context mid-pipeline),
-  # spawn once more with an explicit resume instruction before escalating.
-  if task_status not in ["committed", "abandoned", "escalated"]:
-    spawn_subagent(
-      prompt="Read `.forge/workflows/orchestrate_task.md` and follow it. "
-             "Task ID: {task.taskId}. "
-             "The task is currently at status '{task_status}' — resume from that phase. "
-             "Do not re-run phases that are already complete. "
-             "Also read `engineering/MASTER_INDEX.md` for project state.",
-      description="Resume pipeline for {task.taskId} (was {task_status})",
-      model="sonnet"
-    )
-    task_status = read_task_status(task.taskId)
-    if task_status not in ["committed", "abandoned", "escalated"]:
-      # Two attempts exhausted — escalate and continue with remaining tasks.
-      escalate("Task {task.taskId} did not reach terminal state after re-spawn "
-               "(status: {task_status}). Manual intervention required.")
-      # DO NOT compact mid re-spawn guard — compact only after final status read.
-
-  # Terminal: "committed" → success. "escalated" → note and continue.
-  # Never halt the whole sprint on one escalation.
-
-  # Compact context before next task: all state is on disk
-  remaining = count of tasks not yet in terminal status
-  print(f"[checkpoint] sprint={SPRINT_ID} task={task.taskId} status={task_status} remaining={remaining}")
-  /compact
-```
-
-**All verdict detection, revision loops, escalation, and event emission are
-handled inside the task subagent.** See `orchestrate_task.md`.
-
-### Wave-Parallel Mode
-
-For each wave in dependency order:
-
-1. Create a git worktree per task in the wave:
-   ```bash
-   git worktree add ../worktrees/{TASK_ID} HEAD
-   ```
-2. Spawn one subagent per task in parallel, each running `orchestrate_task.md` inside its worktree
-3. Wait for all subagents in the wave to finish
-4. Merge strategy: rebase each completed worktree onto `main`; on conflict → escalate that task, continue with the rest
-5. Remove worktrees:
-   ```bash
-   git worktree remove ../worktrees/{TASK_ID}
-   ```
-
-### Full-Parallel Mode
-
-Same as wave-parallel but all tasks start simultaneously. Use only when
-every task is independent (no dependencies at all).
-
-## Execution Modes
-
-| Mode | Behaviour |
-|---|---|
-| `sequential` | One task at a time (default) |
-| `wave-parallel` | Tasks in the same dependency wave run in parallel worktrees |
-| `full-parallel` | All tasks run in parallel (use only when fully independent) |
-
-## Step 4 — Post-Sprint
-
-Once all tasks have reached a terminal status:
-
-1. Run collation using the runtime-read pattern:
-   ```bash
-   FORGE_ROOT=$(node -e "console.log(require('./.forge/config.json').paths.forgeRoot)")
-   node "$FORGE_ROOT/tools/collate.cjs"
-   ```
-   Or — 
-2. Summarise outcomes:
-   ```
-   🌊 Sprint {SPRINT_ID} complete.
-   〇 Committed: N tasks
-   △ Escalated: N tasks
-   ── Carried over / abandoned: N tasks
-   ```
-3. Update sprint `status` to `completed` or `partially-completed`
-4. Suggest: "Run `/forge:retro {SPRINT_ID}` to close out the sprint."
-
-## Sprint Lifecycle Hooks
-
-| Hook | When | Action |
-|---|---|---|
-| `collate` | After all tasks terminal | Run `node "$FORGE_ROOT/tools/collate.cjs"` |
-| `report` | After collation | Print outcome summary (committed/escalated/carried-over counts) |
-| `suggest` | After report | Suggest `/forge:retro {SPRINT_ID}` |
-
-## Resume Semantics
-
-If interrupted, re-run `/forge:run-sprint {SPRINT_ID}`. Already-committed tasks are
-skipped. Tasks in mid-pipeline state resume from their current phase
-(the task-level orchestrator reads `status` from disk and continues).
-
-## Event Emission
-
-The sprint runner itself emits `sprint-start`, `sprint-complete`, and
-per-task `task-dispatch` events to `.forge/store/events/{SPRINT_ID}/`.
-Per-phase events are emitted by `orchestrate_task.md` inside each task
-subagent.
-
-## Iron Laws
-
-- Read `.forge/personas/orchestrator.md` first; print the persona identity line to stdout before any other tool use.
-- All store I/O via `forge_store` (or `node "$FORGE_ROOT/tools/store-cli.cjs"`). Never edit `.forge/store/*.json` directly.
-- Follow the Algorithm step by step. Do not skip tasks or skip the dependency sort.
-- Verdict detection and revision loops are handled inside task subagents — the sprint runner must not fabricate results or assume success without evidence.
-- Silent continuation past a failure is never acceptable. Every failure must produce a visible signal and a structured event.
-
-## Store-Write Verification
-
-Every `forge_store` write MUST succeed before advancing. If `store-cli` exits
-non-zero or the `PreToolUse` write-boundary hook blocks the call (exit 2):
-
-1. Parse the structured error (names the offending field + schema file).
-2. Correct the JSON to satisfy the schema.
-3. Retry. Repeat up to 3 times.
-4. After 3 failures, halt and escalate with original payload, corrected payload, and all error messages.
-
-Never set `FORGE_SKIP_WRITE_VALIDATION=1` — operator-only emergency switch.

package/dist/forge-payload/commands/calibrate.md

@@ -1,10 +0,0 @@
----
-name: calibrate
-description: REMOVED in v1.0 — use /forge:health --fix instead
----
-
-# /forge:calibrate — Removed
-
-× `/forge:calibrate` was removed in v1.0. KB drift detection and repair is now handled by `/forge:health --fix` (implemented in T04).
-
-Run `/forge:health` to check overall knowledge base status.

package/dist/forge-payload/commands/materialize.md

@@ -1,119 +0,0 @@
----
-name: materialize
-description: Use when you've run /forge:init --fast and want to fill in missing scaffolding — either for a specific workflow's closure or as a full warm-up. Fills missing or stubbed artifacts; does not change config mode. Unlike /forge:regenerate (which rebuilds regardless), materialize only fills what is missing or stubbed, leaving pristine user-modified files untouched.
----
-
-# /forge:materialize
-
-Fills missing or stubbed Forge scaffolding without overwriting pristine files.
-This is the on-demand complement to `/forge:init --fast`.
-
-`materialize` is **mode-neutral** — it never writes `.forge/config.json`
-`mode`. Promotion from fast → full is a separate explicit decision owned
-by `/forge:config mode full`. After a `materialize --all`, it is normal
-for `mode` to remain `fast` even though every artifact is now present.
-
-## Locate the Forge plugin
-
-```
-FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
-```
-
-Read `.forge/config.json`. If it does not exist, stop and tell the user to run
-`/forge:init` first.
-
-## Arguments
-
-$ARGUMENTS
-
-Parse the argument:
-
-```
-/forge:materialize                          # full warm-up — all stubs + missing
-/forge:materialize --all                    # same as no args
-/forge:materialize workflows plan_task      # just this workflow's closure
-/forge:materialize workflows:plan_task      # colon form
-```
-
----
-
-## Full warm-up (`/forge:materialize` or `--all`)
-
-Open with the forge badge + status line:
-
-```sh
-node "$FORGE_ROOT/tools/banners.cjs" --badge forge
-```
-
-Emit: `〇 forge:materialize — full warm-up…`
-
-Then announce the fast-mode capability state — silent on full installs:
-
-```sh
-node "$FORGE_ROOT/tools/ensure-ready.cjs" --announce --all
-```
-
-`banners.cjs` strips ANSI in `NO_COLOR` / non-tty / `--plain` contexts.
-
-Follow `$FORGE_ROOT/init/generation/lazy-materialize.md` for each stub or missing
-workflow in `.forge/workflows/`. Work from a single collected list:
-
-1. Read `$FORGE_ROOT/schemas/structure-manifest.json` for the full workflow list.
-2. For each workflow id in `namespaces.workflows.files`:
-   - Check if `.forge/workflows/{id}.md` is a stub (starts with `<!-- FORGE FAST-MODE STUB`)
-     or is missing.
-   - Collect all stubs/missing into one list.
-3. Compute the union closure across all stubs/missing workflows.
-4. Fan-out materialisation following the lazy-materialize rulebook steps 5–10
-   for the union closure (one pass, not per-workflow).
-5. Rebuild the persona pack so `meta-orchestrate` and `meta-fix-bug` use
-   a fresh reference index (consumed when `FORGE_PROMPT_MODE=reference`):
-   ```sh
-   node "$FORGE_ROOT/tools/build-persona-pack.cjs" \
-     --out .forge/cache/persona-pack.json
-   ```
-   On exit 1, surface the stderr message (it includes the offending file
-   path) and continue — the pack is refreshable later via `/forge:regenerate`.
-6. Rebuild the architecture context pack:
-   ```sh
-   ENGINEERING=$(node "$FORGE_ROOT/tools/manage-config.cjs" get paths.engineering 2>/dev/null || echo engineering)
-   node "$FORGE_ROOT/tools/build-context-pack.cjs" \
-     --arch-dir "$ENGINEERING/architecture" \
-     --out-md .forge/cache/context-pack.md \
-     --out-json .forge/cache/context-pack.json
-   ```
-   On exit 1 (architecture directory not yet present), emit a warning and
-   continue — the pack can be built later via `/forge:regenerate`.
-7. Emit: `〇 forge:materialize complete — gaps filled (mode unchanged)`
-8. If `.forge/config.json` `mode` is still `"fast"`, append the promotion hint:
-   ```
-   〇 To declare the project fully generated: /forge:config mode full
-   ```
-
----
-
-## Single-workflow (`/forge:materialize workflows <id>`)
-
-Open with the forge badge + status line:
-
-```sh
-node "$FORGE_ROOT/tools/banners.cjs" --badge forge
-```
-
-Emit: `〇 forge:materialize — materialising closure for {id}…`
-
-Follow `$FORGE_ROOT/init/generation/lazy-materialize.md` with `workflow_id={id}`.
-Pass the full argument (caller intent) so the rulebook can re-read and execute
-the real workflow after materialisation.
-
-Do NOT flip config mode for any materialize invocation. Mode is owned by
-`/forge:config`.
-
----
-
-## On error
-
-If any generation step fails unexpectedly:
-
-> "This looks like a Forge bug. Would you like to file a report? Run
-> `/forge:report-bug` — I'll pre-fill the report from this conversation."

package/dist/forge-payload/commands/migrate.md

@@ -1,12 +0,0 @@
----
-name: migrate
-description: REMOVED in v1.0 — use /forge:init --migrate instead
----
-
-# /forge:migrate — Removed
-
-× `/forge:migrate` was removed in v1.0. Store migration is now a flag on `/forge:init`:
-
-- `/forge:init --migrate` — interviews you to map existing store values to Forge format (equivalent to the old `forge:migrate`)
-- `/forge:init --migrate --structural` — runs structural migration for pre-v0.40 stores
-- `/forge:init --migrate --dry-run` — preview changes without applying them

package/dist/forge-payload/commands/quiz-agent.md

@@ -1,6 +0,0 @@
----
-name: quiz-agent
-description: Renamed in v1.0 — use /forge:check-agent
----
-
-× /forge:quiz-agent was renamed to /forge:check-agent in v1.0.

package/dist/forge-payload/commands/regenerate.md

@@ -1,6 +0,0 @@
----
-name: regenerate
-description: Renamed in v1.0 — use /forge:rebuild
----
-
-× /forge:regenerate was renamed to /forge:rebuild in v1.0.

package/dist/forge-payload/commands/store-query.md

@@ -1,6 +0,0 @@
----
-name: store-query
-description: Renamed in v1.0 — use /forge:search
----
-
-× /forge:store-query was renamed to /forge:search in v1.0.

package/dist/forge-payload/commands/store-repair.md

@@ -1,6 +0,0 @@
----
-name: store-repair
-description: Renamed in v1.0 — use /forge:repair
----
-
-× /forge:store-repair was renamed to /forge:repair in v1.0.

package/dist/forge-payload/commands/update-tools.md

@@ -1,10 +0,0 @@
----
-name: update-tools
-description: REMOVED in v1.0 — use /forge:update instead
----
-
-# /forge:update-tools — Removed
-
-× `/forge:update-tools` was removed in v1.0. Schema refresh now happens automatically as part of `/forge:update`.
-
-Run `/forge:update` to refresh schemas along with other project artifacts.

package/dist/forge-payload/meta/templates/meta-retrospective.md

@@ -1,28 +0,0 @@
-# Meta-Template: Sprint Retrospective
-
-## Purpose
-
-Defines the structure of the sprint retrospective document — metrics,
-learnings, and improvements.
-
-## Sections
-
-### Required
-- **Sprint Summary** — tasks completed, failed, carried over
-- **Metrics** — plan iterations, code review iterations, time per task
-- **What Went Well** — patterns that worked
-- **What to Improve** — friction points, recurring issues
-- **Knowledge Base Updates** — what was confirmed, added, or removed
-- **Stack Checklist Changes** — items added or pruned
-
-### Optional
-- **Workflow Improvements** — proposed edits to workflow files
-- **Bug Pattern Analysis** — recurring root cause categories
-- **Merge Conflicts** — if parallel mode, what conflicted and why
-- **Recommendations for Next Sprint** — scope, focus, mode
-
-## Generation Instructions
-- Reference the project's sprint artifact paths for data gathering
-- Reference the project's domain docs and stack checklist
-- Include the project's workflow file paths for proposed edits
-- Reference the project's specific tech debt areas

package/dist/forge-payload/tools/prompts/sprint-plan-prompt.md

@@ -1,70 +0,0 @@
-# Sprint Plan — Architect Persona Prompt
-
-You are acting as the **Forge Architect** (🗻).
-
-Your role: decompose a sprint's requirements into a concrete, dependency-ordered task list. You are a senior technical architect who thinks carefully about sequencing, blast radius, and iron laws before writing a single line of output.
-
----
-
-## Your Task
-
-Read the sprint requirements provided and produce a **JSON array** of task objects. Each task covers one coherent, implementable unit of work. Tasks must be small enough to be planned and implemented in a single sprint sub-task cycle.
-
----
-
-## Output Format
-
-Emit **only** a JSON array — no preamble, no markdown fences, no commentary outside the JSON. The schema:
-
-```json
-[
-  {
-    "taskId": "SPRINT_ID-T01",
-    "title": "Short imperative title (≤80 chars)",
-    "estimate": "S",
-    "dependencies": [],
-    "pipeline": "plan,implement,review,validate,approve,commit",
-    "acceptanceCriteria": [
-      "Specific, verifiable criterion 1",
-      "Specific, verifiable criterion 2"
-    ]
-  }
-]
-```
-
-### Field rules
-
-| Field | Type | Rule |
-|---|---|---|
-| `taskId` | string | `{SPRINT_ID}-T{NN}` — sequential integers starting at 01. Use the sprint ID from the requirements. |
-| `title` | string | Imperative phrase, ≤80 chars. No trailing punctuation. |
-| `estimate` | enum | One of: `S` (≤4h), `M` (≤1d), `L` (≤2d), `XL` (≤5d). |
-| `dependencies` | string[] | Task IDs of tasks this task depends on. Empty array if none. No circular deps. |
-| `pipeline` | string | Default: `"plan,implement,review,validate,approve,commit"`. Adjust only for trivial chores. |
-| `acceptanceCriteria` | string[] | 2–8 specific, verifiable criteria. Each criterion must be independently checkable. No vague phrases like "works correctly". |
-
-### Dependency rules
-
-- Dependencies form a DAG (directed acyclic graph). Circular dependencies are invalid.
-- A release/packaging task always depends on all feature tasks.
-- Tasks that share no code boundary may be declared parallel (no mutual dep).
-- Order tasks so lower-numbered tasks are prerequisites for higher-numbered tasks where possible.
-
----
-
-## Quality Checklist
-
-Before emitting output, verify:
-
-- [ ] Every `taskId` is unique and follows the `{SPRINT_ID}-T{NN}` pattern
-- [ ] No circular dependencies
-- [ ] Each task has at least 2 acceptance criteria
-- [ ] Estimates are realistic (L tasks should not attempt to cover more than 2 full days of work)
-- [ ] A release or packaging task (if applicable) is listed last and depends on all feature tasks
-- [ ] The JSON is valid — parseable without error
-
----
-
-## Sprint Requirements
-
-{SPRINT_REQUIREMENTS}

package/dist/forge-payload/tools/schemas/task-list.schema.json

@@ -1,53 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "TaskList",
-  "description": "JSON Schema for the LLM-generated task list produced by forge:sprint-plan.",
-  "type": "array",
-  "minItems": 1,
-  "items": {
-    "type": "object",
-    "required": ["taskId", "title", "estimate", "dependencies", "pipeline", "acceptanceCriteria"],
-    "additionalProperties": false,
-    "properties": {
-      "taskId": {
-        "type": "string",
-        "pattern": "^[A-Z][A-Z0-9_-]+-T[0-9]+$",
-        "description": "Task identifier in the form {SPRINT_ID}-T{NN}, e.g. FORGE-S20-T01"
-      },
-      "title": {
-        "type": "string",
-        "minLength": 1,
-        "maxLength": 80,
-        "description": "Short imperative title for the task"
-      },
-      "estimate": {
-        "type": "string",
-        "enum": ["S", "M", "L", "XL"],
-        "description": "Size estimate: S (≤4h), M (≤1d), L (≤2d), XL (≤5d)"
-      },
-      "dependencies": {
-        "type": "array",
-        "items": {
-          "type": "string",
-          "pattern": "^[A-Z][A-Z0-9_-]+-T[0-9]+$"
-        },
-        "description": "Task IDs this task depends on. Empty array if no dependencies."
-      },
-      "pipeline": {
-        "type": "string",
-        "minLength": 1,
-        "description": "Comma-separated pipeline phase list, e.g. plan,implement,review,validate,approve,commit"
-      },
-      "acceptanceCriteria": {
-        "type": "array",
-        "minItems": 2,
-        "maxItems": 12,
-        "items": {
-          "type": "string",
-          "minLength": 10
-        },
-        "description": "Specific, verifiable acceptance criteria (2–12 items)"
-      }
-    }
-  }
-}

package/node_modules/@earendil-works/pi-agent-core/dist/harness/execution-env.d.ts

@@ -1,4 +0,0 @@
-export { NodeExecutionEnv } from "./env/nodejs.js";
-export type { ExecutionEnv, ExecutionEnvExecOptions, FileErrorCode, FileInfo, FileKind } from "./types.js";
-export { FileError } from "./types.js";
-//# sourceMappingURL=execution-env.d.ts.map

package/node_modules/@earendil-works/pi-agent-core/dist/harness/execution-env.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"execution-env.d.ts","sourceRoot":"","sources":["../../src/harness/execution-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { NodeExecutionEnv } from \"./env/nodejs.js\";\nexport type { ExecutionEnv, ExecutionEnvExecOptions, FileErrorCode, FileInfo, FileKind } from \"./types.js\";\nexport { FileError } from \"./types.js\";\n"]}

package/node_modules/@earendil-works/pi-agent-core/dist/harness/execution-env.js

@@ -1,3 +0,0 @@
-export { NodeExecutionEnv } from "./env/nodejs.js";
-export { FileError } from "./types.js";
-//# sourceMappingURL=execution-env.js.map

package/node_modules/@earendil-works/pi-agent-core/dist/harness/execution-env.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"execution-env.js","sourceRoot":"","sources":["../../src/harness/execution-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { NodeExecutionEnv } from \"./env/nodejs.js\";\nexport type { ExecutionEnv, ExecutionEnvExecOptions, FileErrorCode, FileInfo, FileKind } from \"./types.js\";\nexport { FileError } from \"./types.js\";\n"]}

package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/repo/jsonl.d.ts

@@ -1,20 +0,0 @@
-import type { JsonlSessionCreateOptions, JsonlSessionListOptions, JsonlSessionMetadata, JsonlSessionRepoApi, Session } from "../../types.js";
-export declare class JsonlSessionRepo implements JsonlSessionRepoApi {
-    private sessionsRoot;
-    constructor(options: {
-        sessionsRoot: string;
-    });
-    private getSessionDir;
-    private createSessionFilePath;
-    create(options: JsonlSessionCreateOptions): Promise<Session<JsonlSessionMetadata>>;
-    open(metadata: JsonlSessionMetadata): Promise<Session<JsonlSessionMetadata>>;
-    list(options?: JsonlSessionListOptions): Promise<JsonlSessionMetadata[]>;
-    delete(metadata: JsonlSessionMetadata): Promise<void>;
-    fork(sourceMetadata: JsonlSessionMetadata, options: JsonlSessionCreateOptions & {
-        entryId?: string;
-        position?: "before" | "at";
-        id?: string;
-    }): Promise<Session<JsonlSessionMetadata>>;
-    private listSessionDirs;
-}
-//# sourceMappingURL=jsonl.d.ts.map

package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/repo/jsonl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../../../src/harness/session/repo/jsonl.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,OAAO,EACP,MAAM,gBAAgB,CAAC;AAiBxB,qBAAa,gBAAiB,YAAW,mBAAmB;IAC3D,OAAO,CAAC,YAAY,CAAS;IAE7B,YAAY,OAAO,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,EAE5C;IAED,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,qBAAqB;IAIvB,MAAM,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAWvF;IAEK,IAAI,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAMjF;IAEK,IAAI,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAgBjF;IAEK,MAAM,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;IAEK,IAAI,CACT,cAAc,EAAE,oBAAoB,EACpC,OAAO,EAAE,yBAAyB,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAChG,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAcxC;YAEa,eAAe;CAK7B","sourcesContent":["import { constants } from \"node:fs\";\nimport { access, mkdir, readdir, rm } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport type {\n\tJsonlSessionCreateOptions,\n\tJsonlSessionListOptions,\n\tJsonlSessionMetadata,\n\tJsonlSessionRepoApi,\n\tSession,\n} from \"../../types.js\";\nimport { JsonlSessionStorage, loadJsonlSessionMetadata } from \"../storage/jsonl.js\";\nimport { createSessionId, createTimestamp, getEntriesToFork, toSession } from \"./shared.js\";\n\nasync function exists(path: string): Promise<boolean> {\n\ttry {\n\t\tawait access(path, constants.F_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction encodeCwd(cwd: string): string {\n\treturn `--${cwd.replace(/^[/\\\\]/, \"\").replace(/[/\\\\:]/g, \"-\")}--`;\n}\n\nexport class JsonlSessionRepo implements JsonlSessionRepoApi {\n\tprivate sessionsRoot: string;\n\n\tconstructor(options: { sessionsRoot: string }) {\n\t\tthis.sessionsRoot = resolve(options.sessionsRoot);\n\t}\n\n\tprivate getSessionDir(cwd: string): string {\n\t\treturn join(this.sessionsRoot, encodeCwd(cwd));\n\t}\n\n\tprivate createSessionFilePath(cwd: string, sessionId: string, timestamp: string): string {\n\t\treturn join(this.getSessionDir(cwd), `${timestamp.replace(/[:.]/g, \"-\")}_${sessionId}.jsonl`);\n\t}\n\n\tasync create(options: JsonlSessionCreateOptions): Promise<Session<JsonlSessionMetadata>> {\n\t\tawait mkdir(this.sessionsRoot, { recursive: true });\n\t\tconst id = options.id ?? createSessionId();\n\t\tconst createdAt = createTimestamp();\n\t\tconst filePath = this.createSessionFilePath(options.cwd, id, createdAt);\n\t\tconst storage = await JsonlSessionStorage.create(filePath, {\n\t\t\tcwd: options.cwd,\n\t\t\tsessionId: id,\n\t\t\tparentSessionPath: options.parentSessionPath,\n\t\t});\n\t\treturn toSession(storage);\n\t}\n\n\tasync open(metadata: JsonlSessionMetadata): Promise<Session<JsonlSessionMetadata>> {\n\t\tif (!(await exists(metadata.path))) {\n\t\t\tthrow new Error(`Session not found: ${metadata.path}`);\n\t\t}\n\t\tconst storage = await JsonlSessionStorage.open(metadata.path);\n\t\treturn toSession(storage);\n\t}\n\n\tasync list(options: JsonlSessionListOptions = {}): Promise<JsonlSessionMetadata[]> {\n\t\tconst dirs = options.cwd ? [this.getSessionDir(options.cwd)] : await this.listSessionDirs();\n\t\tconst sessions: JsonlSessionMetadata[] = [];\n\t\tfor (const dir of dirs) {\n\t\t\tif (!(await exists(dir))) continue;\n\t\t\tconst files = (await readdir(dir)).filter((file) => file.endsWith(\".jsonl\")).map((file) => join(dir, file));\n\t\t\tfor (const filePath of files) {\n\t\t\t\ttry {\n\t\t\t\t\tsessions.push(await loadJsonlSessionMetadata(filePath));\n\t\t\t\t} catch {\n\t\t\t\t\t// Ignore invalid session files when listing a directory.\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tsessions.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());\n\t\treturn sessions;\n\t}\n\n\tasync delete(metadata: JsonlSessionMetadata): Promise<void> {\n\t\tawait rm(metadata.path, { force: true });\n\t}\n\n\tasync fork(\n\t\tsourceMetadata: JsonlSessionMetadata,\n\t\toptions: JsonlSessionCreateOptions & { entryId?: string; position?: \"before\" | \"at\"; id?: string },\n\t): Promise<Session<JsonlSessionMetadata>> {\n\t\tconst source = await this.open(sourceMetadata);\n\t\tconst forkedEntries = await getEntriesToFork(source.getStorage(), options);\n\t\tconst id = options.id ?? createSessionId();\n\t\tconst createdAt = createTimestamp();\n\t\tconst storage = await JsonlSessionStorage.create(this.createSessionFilePath(options.cwd, id, createdAt), {\n\t\t\tcwd: options.cwd,\n\t\t\tsessionId: id,\n\t\t\tparentSessionPath: options.parentSessionPath ?? sourceMetadata.path,\n\t\t});\n\t\tfor (const entry of forkedEntries) {\n\t\t\tawait storage.appendEntry(entry);\n\t\t}\n\t\treturn toSession(storage);\n\t}\n\n\tprivate async listSessionDirs(): Promise<string[]> {\n\t\tif (!(await exists(this.sessionsRoot))) return [];\n\t\tconst entries = await readdir(this.sessionsRoot, { withFileTypes: true });\n\t\treturn entries.filter((entry) => entry.isDirectory()).map((entry) => join(this.sessionsRoot, entry.name));\n\t}\n}\n"]}