ctxr-cli 0.1.0

package/dist/commands/migrate.js

@@ -0,0 +1,56 @@
+import { readConfig } from '../config/load.js';
+import { SUPPORTED_SCHEMA_VERSION } from '../config/schema.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { pendingMigrations } from '../core/migrations/registry.js';
+export const requires = { store: 'required' };
+/**
+ * store-lifecycle spec: `--dry-run` reports exact deltas with nothing
+ * applied; a real run applies each pending migration in order, reloading
+ * the store's config after each one so a later migration in the chain
+ * (none exist yet, but the mechanism supports it) sees the version it
+ * actually needs to start from. Resumability is a property of each
+ * migration's own plan()/apply() (see core/migrations/types.ts) — this
+ * command does no extra bookkeeping of its own.
+ */
+export async function execute(store, flags) {
+    const pending = pendingMigrations(store.config.schema_version);
+    const startingVersion = store.config.schema_version;
+    if (pending.length === 0) {
+        return {
+            exitCode: ExitCode.Ok,
+            data: { currentVersion: startingVersion, targetVersion: SUPPORTED_SCHEMA_VERSION, applied: false, migrations: [] },
+            findings: [],
+            humanSummary: `Already at schema_version ${startingVersion}; nothing to migrate.`,
+            storeRoot: store.root,
+            schemaVersion: store.config.schema_version,
+        };
+    }
+    const results = [];
+    let workingStore = store;
+    for (const migration of pending) {
+        if (flags.dryRun) {
+            const deltas = await migration.plan(workingStore);
+            results.push({ id: migration.id, fromVersion: migration.fromVersion, toVersion: migration.toVersion, deltas });
+            continue;
+        }
+        const deltas = await migration.apply(workingStore);
+        results.push({ id: migration.id, fromVersion: migration.fromVersion, toVersion: migration.toVersion, deltas });
+        workingStore = { root: workingStore.root, config: await readConfig(workingStore.root) };
+    }
+    return {
+        exitCode: ExitCode.Ok,
+        data: {
+            currentVersion: startingVersion,
+            targetVersion: SUPPORTED_SCHEMA_VERSION,
+            applied: !flags.dryRun,
+            migrations: results,
+        },
+        findings: [],
+        humanSummary: flags.dryRun
+            ? `--dry-run: ${results.reduce((n, r) => n + r.deltas.length, 0)} change(s) would be made across ${results.length} migration(s).`
+            : `Applied ${results.length} migration(s), now at schema_version ${workingStore.config.schema_version}.`,
+        storeRoot: store.root,
+        schemaVersion: flags.dryRun ? store.config.schema_version : workingStore.config.schema_version,
+    };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/commands/migrate.js.map

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

package/dist/commands/note-resolve.d.ts

@@ -0,0 +1,14 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { RunEnv } from '../core/env.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface NoteResolveFlags {
+    path: string;
+}
+export interface NoteResolveData {
+    path: string;
+    visibility: string;
+    reason: string;
+}
+export declare function execute(env: RunEnv, store: Store, flags: NoteResolveFlags): Promise<CommandOutcome<NoteResolveData>>;
+//# sourceMappingURL=note-resolve.d.ts.map

package/dist/commands/note-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-resolve.d.ts","sourceRoot":"","sources":["../../src/commands/note-resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAOD,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAc1C"}

package/dist/commands/note-resolve.js

@@ -0,0 +1,24 @@
+import path from 'node:path';
+import { ExitCode } from '../core/exit-codes.js';
+import { parseNote } from '../core/notes/parse.js';
+import { resolveVisibility } from '../core/notes/visibility.js';
+export const requires = { store: 'required' };
+function toStoreRelativePath(env, store, givenPath) {
+    const absolute = path.isAbsolute(givenPath) ? givenPath : path.resolve(env.cwd, givenPath);
+    return path.relative(store.root, absolute).split(path.sep).join('/');
+}
+export async function execute(env, store, flags) {
+    const relativePath = toStoreRelativePath(env, store, flags.path);
+    const absolutePath = path.join(store.root, relativePath);
+    const note = await parseNote(absolutePath, relativePath);
+    const resolution = resolveVisibility(store.config, note);
+    return {
+        exitCode: ExitCode.Ok,
+        data: { path: relativePath, visibility: resolution.value, reason: resolution.reason },
+        findings: [],
+        humanSummary: `${relativePath}: ${resolution.value} (${resolution.reason})`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=note-resolve.js.map

package/dist/commands/note-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-resolve.js","sourceRoot":"","sources":["../../src/commands/note-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAY/D,SAAS,mBAAmB,CAAC,GAAW,EAAE,KAAY,EAAE,SAAiB;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC3F,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAW,EACX,KAAY,EACZ,KAAuB;IAEvB,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEzD,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE;QACrF,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,GAAG,YAAY,KAAK,UAAU,CAAC,KAAK,KAAK,UAAU,CAAC,MAAM,GAAG;QAC3E,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/rollup-gather.d.ts

@@ -0,0 +1,21 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { RunEnv } from '../core/env.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface RollupGatherFlags {
+    entity: string;
+}
+export interface RollupGatherData {
+    entity: string;
+    candidates: string[];
+}
+/**
+ * context-organize spec (task 7.3): agent-facing enumeration only — this
+ * command finds candidate source notes (every note linking to the entity
+ * by wikilink), it does not read or synthesize them. The actual judgment
+ * of what belongs in a rollup, and the prose itself, stays with the agent;
+ * `rollup write` is the separate, deterministic step that commits that
+ * agent-authored prose to disk.
+ */
+export declare function execute(env: RunEnv, store: Store, flags: RollupGatherFlags): Promise<CommandOutcome<RollupGatherData>>;
+//# sourceMappingURL=rollup-gather.d.ts.map

package/dist/commands/rollup-gather.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup-gather.d.ts","sourceRoot":"","sources":["../../src/commands/rollup-gather.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAK7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAOD;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAoB3C"}

package/dist/commands/rollup-gather.js

@@ -0,0 +1,40 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { NoteNotFoundError } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { extractLinkTargets } from '../core/graph/model.js';
+import { listNotes } from '../core/notes/list.js';
+export const requires = { store: 'required' };
+function toStoreRelativePath(env, store, givenPath) {
+    const absolute = path.isAbsolute(givenPath) ? givenPath : path.resolve(env.cwd, givenPath);
+    return path.relative(store.root, absolute).split(path.sep).join('/');
+}
+/**
+ * context-organize spec (task 7.3): agent-facing enumeration only — this
+ * command finds candidate source notes (every note linking to the entity
+ * by wikilink), it does not read or synthesize them. The actual judgment
+ * of what belongs in a rollup, and the prose itself, stays with the agent;
+ * `rollup write` is the separate, deterministic step that commits that
+ * agent-authored prose to disk.
+ */
+export async function execute(env, store, flags) {
+    const relativePath = toStoreRelativePath(env, store, flags.entity);
+    if (!existsSync(path.join(store.root, relativePath)))
+        throw new NoteNotFoundError(relativePath);
+    const stem = path.basename(relativePath, '.md');
+    const notes = await listNotes(store.root, store.config);
+    const candidates = notes
+        .filter((note) => note.path !== relativePath)
+        .filter((note) => extractLinkTargets(note.body).includes(stem))
+        .map((note) => note.path)
+        .sort();
+    return {
+        exitCode: ExitCode.Ok,
+        data: { entity: relativePath, candidates },
+        findings: [],
+        humanSummary: `${candidates.length} candidate source note(s) for "${relativePath}".`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=rollup-gather.js.map

package/dist/commands/rollup-gather.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup-gather.js","sourceRoot":"","sources":["../../src/commands/rollup-gather.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAW/D,SAAS,mBAAmB,CAAC,GAAW,EAAE,KAAY,EAAE,SAAiB;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC3F,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAW,EACX,KAAY,EACZ,KAAwB;IAExB,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAAE,MAAM,IAAI,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAEhG,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,KAAK;SACrB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC;SAC5C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;SAC9D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,EAAE,CAAC;IAEV,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE;QAC1C,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,GAAG,UAAU,CAAC,MAAM,kCAAkC,YAAY,IAAI;QACpF,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/rollup-write.d.ts

@@ -0,0 +1,25 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { RunEnv } from '../core/env.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export declare const ROLLUP_FENCE: import("../core/markers.js").Fence;
+export interface RollupWriteFlags {
+    entity: string;
+    contentFile: string;
+}
+export interface RollupWriteData {
+    path: string;
+    changed: boolean;
+}
+/**
+ * context-organize spec (task 7.3): an idempotent fenced write via the
+ * Phase 1 marker-fence primitive — identical content on a second run is a
+ * true no-op (byte-identical file, no write at all), and a pre-existing
+ * mismatched marker pair in the entity note aborts with zero bytes
+ * written, exactly like every other generated-region writer in this
+ * codebase. The rollup text itself is supplied by the caller (an agent
+ * that already did the reading and synthesis via `rollup gather`'s
+ * candidates) — this command's only job is the deterministic write.
+ */
+export declare function execute(env: RunEnv, store: Store, flags: RollupWriteFlags): Promise<CommandOutcome<RollupWriteData>>;
+//# sourceMappingURL=rollup-write.d.ts.map

package/dist/commands/rollup-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup-write.d.ts","sourceRoot":"","sources":["../../src/commands/rollup-write.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAK7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,eAAO,MAAM,YAAY,oCAA6B,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAOD;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAmB1C"}

package/dist/commands/rollup-write.js

@@ -0,0 +1,43 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { NoteNotFoundError } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { upsertFencedRegionInFile } from '../core/fs/fenced-region.js';
+import { htmlCommentFence } from '../core/markers.js';
+export const requires = { store: 'required' };
+export const ROLLUP_FENCE = htmlCommentFence('rollup');
+function toStoreRelativePath(env, store, givenPath) {
+    const absolute = path.isAbsolute(givenPath) ? givenPath : path.resolve(env.cwd, givenPath);
+    return path.relative(store.root, absolute).split(path.sep).join('/');
+}
+/**
+ * context-organize spec (task 7.3): an idempotent fenced write via the
+ * Phase 1 marker-fence primitive — identical content on a second run is a
+ * true no-op (byte-identical file, no write at all), and a pre-existing
+ * mismatched marker pair in the entity note aborts with zero bytes
+ * written, exactly like every other generated-region writer in this
+ * codebase. The rollup text itself is supplied by the caller (an agent
+ * that already did the reading and synthesis via `rollup gather`'s
+ * candidates) — this command's only job is the deterministic write.
+ */
+export async function execute(env, store, flags) {
+    const relativePath = toStoreRelativePath(env, store, flags.entity);
+    const absolutePath = path.join(store.root, relativePath);
+    if (!existsSync(absolutePath))
+        throw new NoteNotFoundError(relativePath);
+    const contentText = await readFile(flags.contentFile, 'utf8');
+    const bodyLines = contentText.split('\n');
+    if (bodyLines.length > 0 && bodyLines[bodyLines.length - 1] === '')
+        bodyLines.pop();
+    const { changed } = await upsertFencedRegionInFile(absolutePath, ROLLUP_FENCE, bodyLines);
+    return {
+        exitCode: ExitCode.Ok,
+        data: { path: relativePath, changed },
+        findings: [],
+        humanSummary: changed ? `Rollup written into "${relativePath}".` : `Rollup in "${relativePath}" already up to date.`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=rollup-write.js.map

package/dist/commands/rollup-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup-write.js","sourceRoot":"","sources":["../../src/commands/rollup-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAE/D,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAYvD,SAAS,mBAAmB,CAAC,GAAW,EAAE,KAAY,EAAE,SAAiB;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC3F,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAW,EACX,KAAY,EACZ,KAAuB;IAEvB,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,MAAM,IAAI,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAEzE,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE;QAAE,SAAS,CAAC,GAAG,EAAE,CAAC;IAEpF,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,wBAAwB,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IAE1F,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE;QACrC,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,wBAAwB,YAAY,IAAI,CAAC,CAAC,CAAC,cAAc,YAAY,uBAAuB;QACpH,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/session-abandon.d.ts

@@ -0,0 +1,13 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { RunEnv } from '../core/env.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface SessionAbandonFlags {
+    branch: string;
+}
+export interface SessionAbandonData {
+    branch: string;
+    worktree: string;
+}
+export declare function execute(env: RunEnv, store: Store, flags: SessionAbandonFlags): Promise<CommandOutcome<SessionAbandonData>>;
+//# sourceMappingURL=session-abandon.d.ts.map

package/dist/commands/session-abandon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-abandon.d.ts","sourceRoot":"","sources":["../../src/commands/session-abandon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAkB7C"}

package/dist/commands/session-abandon.js

@@ -0,0 +1,22 @@
+import { SessionNotFoundError } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { deleteBranch, listWorktrees, removeWorktree } from '../core/git/worktree.js';
+export const requires = { store: 'required' };
+export async function execute(env, store, flags) {
+    const worktrees = await listWorktrees(env.git, store.root);
+    const match = worktrees.find((w) => w.branch === flags.branch);
+    if (!match) {
+        throw new SessionNotFoundError(flags.branch);
+    }
+    await removeWorktree(env.git, store.root, match.path, { force: true });
+    await deleteBranch(env.git, store.root, flags.branch, { force: true });
+    return {
+        exitCode: ExitCode.Ok,
+        data: { branch: flags.branch, worktree: match.path },
+        findings: [],
+        humanSummary: `Abandoned session "${flags.branch}" and removed its worktree.`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=session-abandon.js.map

package/dist/commands/session-abandon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-abandon.js","sourceRoot":"","sources":["../../src/commands/session-abandon.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGtF,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAW/D,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAW,EACX,KAAY,EACZ,KAA0B;IAE1B,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,MAAM,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvE,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE;QACpD,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,sBAAsB,KAAK,CAAC,MAAM,6BAA6B;QAC7E,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/session-list.d.ts

@@ -0,0 +1,14 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { RunEnv } from '../core/env.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface SessionInfo {
+    branch: string;
+    worktree: string;
+    head: string;
+}
+export interface SessionListData {
+    sessions: SessionInfo[];
+}
+export declare function execute(env: RunEnv, store: Store): Promise<CommandOutcome<SessionListData>>;
+//# sourceMappingURL=session-list.d.ts.map

package/dist/commands/session-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-list.d.ts","sourceRoot":"","sources":["../../src/commands/session-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAcjG"}

package/dist/commands/session-list.js

@@ -0,0 +1,19 @@
+import { ExitCode } from '../core/exit-codes.js';
+import { listWorktrees } from '../core/git/worktree.js';
+import { isSessionBranch } from '../core/session.js';
+export const requires = { store: 'required' };
+export async function execute(env, store) {
+    const worktrees = await listWorktrees(env.git, store.root);
+    const sessions = worktrees
+        .filter((w) => w.branch !== null && isSessionBranch(store.config, w.branch))
+        .map((w) => ({ branch: w.branch, worktree: w.path, head: w.head }));
+    return {
+        exitCode: ExitCode.Ok,
+        data: { sessions },
+        findings: [],
+        humanSummary: `${sessions.length} session(s).`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=session-list.js.map

package/dist/commands/session-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-list.js","sourceRoot":"","sources":["../../src/commands/session-list.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAY/D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,KAAY;IACrD,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,SAAS;SACvB,MAAM,CAAC,CAAC,CAAC,EAAsC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;SAC/G,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEtE,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,QAAQ,EAAE;QAClB,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,GAAG,QAAQ,CAAC,MAAM,cAAc;QAC9C,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/session-reap.d.ts

@@ -0,0 +1,22 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { RunEnv } from '../core/env.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface ReapOutcome {
+    branch: string;
+    worktree: string;
+    reason: string;
+}
+export interface SessionReapData {
+    reaped: ReapOutcome[];
+    skipped: ReapOutcome[];
+}
+/**
+ * write-lifecycle spec: reclaims session worktrees whose branch has been
+ * merged into the default branch and whose tree is clean — never a branch
+ * with unmerged commits, never a dirty worktree. This removes the
+ * concurrency race entirely rather than hardening against it: a
+ * conservative reap that only ever touches provably-safe sessions.
+ */
+export declare function execute(env: RunEnv, store: Store): Promise<CommandOutcome<SessionReapData>>;
+//# sourceMappingURL=session-reap.d.ts.map

package/dist/commands/session-reap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-reap.d.ts","sourceRoot":"","sources":["../../src/commands/session-reap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAK7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CA2CjG"}

package/dist/commands/session-reap.js

@@ -0,0 +1,47 @@
+import { ExitCode } from '../core/exit-codes.js';
+import { isWorkingTreeClean } from '../core/git/repo.js';
+import { deleteBranch, listWorktrees, removeWorktree } from '../core/git/worktree.js';
+import { isSessionBranch } from '../core/session.js';
+export const requires = { store: 'required' };
+/**
+ * write-lifecycle spec: reclaims session worktrees whose branch has been
+ * merged into the default branch and whose tree is clean — never a branch
+ * with unmerged commits, never a dirty worktree. This removes the
+ * concurrency race entirely rather than hardening against it: a
+ * conservative reap that only ever touches provably-safe sessions.
+ */
+export async function execute(env, store) {
+    const worktrees = await listWorktrees(env.git, store.root);
+    const sessions = worktrees.filter((w) => w.branch !== null && isSessionBranch(store.config, w.branch));
+    const reaped = [];
+    const skipped = [];
+    for (const session of sessions) {
+        const clean = await isWorkingTreeClean(env.git, session.path);
+        if (!clean) {
+            skipped.push({ branch: session.branch, worktree: session.path, reason: 'worktree has uncommitted changes' });
+            continue;
+        }
+        const aheadResult = await env.git.run(['log', `${store.config.git.default_branch}..${session.branch}`, '--oneline'], { cwd: store.root, allowFailure: true });
+        const isMerged = aheadResult.exitCode === 0 && aheadResult.stdout.trim().length === 0;
+        if (!isMerged) {
+            skipped.push({
+                branch: session.branch,
+                worktree: session.path,
+                reason: 'branch has commits not yet merged into the default branch',
+            });
+            continue;
+        }
+        await removeWorktree(env.git, store.root, session.path);
+        await deleteBranch(env.git, store.root, session.branch);
+        reaped.push({ branch: session.branch, worktree: session.path, reason: 'merged and clean' });
+    }
+    return {
+        exitCode: ExitCode.Ok,
+        data: { reaped, skipped },
+        findings: [],
+        humanSummary: `Reaped ${reaped.length} session(s), skipped ${skipped.length}.`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=session-reap.js.map

package/dist/commands/session-reap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-reap.js","sourceRoot":"","sources":["../../src/commands/session-reap.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAa/D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,KAAY;IACrD,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAC/B,CAAC,CAAC,EAAsC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CACxG,CAAC;IAEF,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC,CAAC;YAC7G,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CACnC,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,KAAK,OAAO,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,EAC7E,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CACxC,CAAC;QACF,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;QACtF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,IAAI;gBACtB,MAAM,EAAE,2DAA2D;aACpE,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;QACzB,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,UAAU,MAAM,CAAC,MAAM,wBAAwB,OAAO,CAAC,MAAM,GAAG;QAC9E,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/session-start.d.ts

@@ -0,0 +1,18 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { RunEnv } from '../core/env.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface SessionStartData {
+    worktree: string;
+    branch: string;
+    startPoint: string;
+    fetched: boolean;
+}
+/**
+ * write-lifecycle spec: "session start (an isolated git worktree off a
+ * freshly fetched default branch)." When no remote is configured (a purely
+ * local store), this degrades honestly to the local default branch's
+ * current tip — fetching is simply not possible without a remote.
+ */
+export declare function execute(env: RunEnv, store: Store): Promise<CommandOutcome<SessionStartData>>;
+//# sourceMappingURL=session-start.d.ts.map

package/dist/commands/session-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../src/commands/session-start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CA4BlG"}

package/dist/commands/session-start.js

@@ -0,0 +1,36 @@
+import { ExitCode } from '../core/exit-codes.js';
+import { addWorktree, fetchOrigin, hasRemote } from '../core/git/worktree.js';
+import { generateSessionBranchName, worktreePathFor } from '../core/session.js';
+export const requires = { store: 'required' };
+/**
+ * write-lifecycle spec: "session start (an isolated git worktree off a
+ * freshly fetched default branch)." When no remote is configured (a purely
+ * local store), this degrades honestly to the local default branch's
+ * current tip — fetching is simply not possible without a remote.
+ */
+export async function execute(env, store) {
+    const git = env.git;
+    const defaultBranch = store.config.git.default_branch;
+    const remoteExists = await hasRemote(git, store.root);
+    let startPoint;
+    let fetched = false;
+    if (remoteExists) {
+        fetched = await fetchOrigin(git, store.root, defaultBranch);
+    }
+    // Falls back to the local branch both when there's no remote at all, and
+    // when the remote exists but doesn't yet have this branch (e.g. nothing
+    // has been pushed yet) — both are honest, expected states, not errors.
+    startPoint = fetched ? `origin/${defaultBranch}` : defaultBranch;
+    const branch = generateSessionBranchName(store.config);
+    const worktreeDir = worktreePathFor(store, branch);
+    await addWorktree(git, store.root, worktreeDir, branch, startPoint);
+    return {
+        exitCode: ExitCode.Ok,
+        data: { worktree: worktreeDir, branch, startPoint, fetched },
+        findings: [],
+        humanSummary: `Session worktree at "${worktreeDir}" on branch "${branch}" (from ${startPoint}).`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=session-start.js.map

package/dist/commands/session-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../src/commands/session-start.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGhF,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAS/D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,KAAY;IACrD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;IACtD,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAEtD,IAAI,UAAkB,CAAC;IACvB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC9D,CAAC;IACD,yEAAyE;IACzE,wEAAwE;IACxE,uEAAuE;IACvE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;IAEjE,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEnD,MAAM,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAEpE,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE;QAC5D,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,wBAAwB,WAAW,gBAAgB,MAAM,WAAW,UAAU,IAAI;QAChG,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/session-submit.d.ts

@@ -0,0 +1,27 @@
+import type { OpenPullRequestResult } from '../adapters/forge/types.js';
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { RunEnv } from '../core/env.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface SessionSubmitFlags {
+    message?: string;
+    title?: string;
+    body?: string;
+}
+export interface SessionSubmitData {
+    branch: string;
+    commit: string | null;
+    pushed: boolean;
+    pr: OpenPullRequestResult | null;
+    manualPrInstructions: string | null;
+}
+/**
+ * write-lifecycle spec: "runs full validation, commits, pushes the branch,
+ * opens a PR via the configured forge adapter (or degrades per 2.5);
+ * refuses to run if validation fails." Full validation here means the same
+ * store-scope invariant set doctor runs — not just what's currently staged
+ * — because a session's job is to leave the store healthy as a whole, not
+ * merely to pass each individual commit's pre-commit gate.
+ */
+export declare function execute(env: RunEnv, store: Store, flags: SessionSubmitFlags): Promise<CommandOutcome<SessionSubmitData>>;
+//# sourceMappingURL=session-submit.d.ts.map

package/dist/commands/session-submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-submit.d.ts","sourceRoot":"","sources":["../../src/commands/session-submit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAIxE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAO7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,EAAE,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACjC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CA0D5C"}

package/dist/commands/session-submit.js

@@ -0,0 +1,68 @@
+import { configuredAdapters } from '../adapters/registry.js';
+import { CHECKS } from '../core/checks/manifest.js';
+import { overallStatus, runChecks } from '../core/checks/registry.js';
+import { NoRemoteConfiguredError, SessionValidationFailedError } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { commitIfStaged, currentBranch, pushBranch } from '../core/git/repo.js';
+import { hasRemote } from '../core/git/worktree.js';
+import { readGraph } from '../core/graph/persist.js';
+import { listNotes } from '../core/notes/list.js';
+export const requires = { store: 'required' };
+/**
+ * write-lifecycle spec: "runs full validation, commits, pushes the branch,
+ * opens a PR via the configured forge adapter (or degrades per 2.5);
+ * refuses to run if validation fails." Full validation here means the same
+ * store-scope invariant set doctor runs — not just what's currently staged
+ * — because a session's job is to leave the store healthy as a whole, not
+ * merely to pass each individual commit's pre-commit gate.
+ */
+export async function execute(env, store, flags) {
+    const branch = await currentBranch(env.git, store.root);
+    const ctx = {
+        storeRoot: store.root,
+        config: store.config,
+        scope: 'store',
+        git: env.git,
+        notes: () => listNotes(store.root, store.config),
+        graph: () => readGraph(store),
+        catalog: async () => undefined,
+    };
+    const reports = await runChecks(CHECKS, ctx, { scope: 'store', severity: 'invariant' });
+    if (overallStatus(reports) === 'fail') {
+        throw new SessionValidationFailedError(reports.flatMap((r) => r.result.findings));
+    }
+    if (!(await hasRemote(env.git, store.root))) {
+        throw new NoRemoteConfiguredError();
+    }
+    const commitSha = await commitIfStaged(env.git, store.root, { kind: 'session', worktree: store.root, branch }, flags.message ?? `chore: submit session ${branch}`);
+    await pushBranch(env.git, store.root, branch);
+    let pr = null;
+    let manualPrInstructions = null;
+    // adapters spec: "No forge adapter configured" is a documented degradation,
+    // not a crash — the commit-and-push above still completed either way.
+    const [forgeAdapter] = configuredAdapters(store.config, 'forge');
+    const forgeAvailable = forgeAdapter ? await forgeAdapter.isAvailable(store.root) : false;
+    if (forgeAdapter && forgeAvailable) {
+        pr = await forgeAdapter.openPullRequest({
+            cwd: store.root,
+            branch,
+            baseBranch: store.config.git.default_branch,
+            title: flags.title ?? `Session: ${branch}`,
+            body: flags.body ?? '',
+        });
+    }
+    else {
+        manualPrInstructions =
+            `No forge adapter is configured or reachable. The branch "${branch}" was pushed successfully — ` +
+                `open a pull request manually, comparing it against "${store.config.git.default_branch}".`;
+    }
+    return {
+        exitCode: ExitCode.Ok,
+        data: { branch, commit: commitSha, pushed: true, pr, manualPrInstructions },
+        findings: [],
+        humanSummary: pr ? `Opened PR #${pr.number ?? '?'}: ${pr.url}` : (manualPrInstructions ?? ''),
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=session-submit.js.map

package/dist/commands/session-submit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-submit.js","sourceRoot":"","sources":["../../src/commands/session-submit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAItE,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAgB/D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAW,EACX,KAAY,EACZ,KAAyB;IAEzB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAExD,MAAM,GAAG,GAAiB;QACxB,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;QAChD,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC;QAC7B,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;KAC/B,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IACxF,IAAI,aAAa,CAAC,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;QACtC,MAAM,IAAI,4BAA4B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,uBAAuB,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,cAAc,CACpC,GAAG,CAAC,GAAG,EACP,KAAK,CAAC,IAAI,EACV,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EACjD,KAAK,CAAC,OAAO,IAAI,yBAAyB,MAAM,EAAE,CACnD,CAAC;IAEF,MAAM,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE9C,IAAI,EAAE,GAAiC,IAAI,CAAC;IAC5C,IAAI,oBAAoB,GAAkB,IAAI,CAAC;IAC/C,4EAA4E;IAC5E,sEAAsE;IACtE,MAAM,CAAC,YAAY,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjE,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACzF,IAAI,YAAY,IAAI,cAAc,EAAE,CAAC;QACnC,EAAE,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC;YACtC,GAAG,EAAE,KAAK,CAAC,IAAI;YACf,MAAM;YACN,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc;YAC3C,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,YAAY,MAAM,EAAE;YAC1C,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;SACvB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,oBAAoB;YAClB,4DAA4D,MAAM,8BAA8B;gBAChG,uDAAuD,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC;IAC/F,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,oBAAoB,EAAE;QAC3E,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,oBAAoB,IAAI,EAAE,CAAC;QAC7F,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}