@software-dlc/cli 0.157.2

package/dist/local/state-directory.d.ts

@@ -0,0 +1,17 @@
+export type LocalStateDirectoryResolution = {
+    state_dir: string;
+    source: 'default' | 'override';
+    warning: string | null;
+};
+export declare function resolveLocalStateDirectory(input: {
+    repository_root: string;
+    sidecar_dir?: string;
+    override?: string;
+}): LocalStateDirectoryResolution;
+export declare function prepareLocalStateDirectory(input: {
+    repository_root: string;
+    git_dir: string;
+    sidecar_dir?: string;
+    override?: string;
+}): Promise<LocalStateDirectoryResolution>;
+//# sourceMappingURL=state-directory.d.ts.map

package/dist/local/state-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-directory.d.ts","sourceRoot":"","sources":["../../src/local/state-directory.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,6BAA6B,GAAG;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,6BAA6B,CAkBhC;AA4CD,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAoBzC"}

package/dist/local/state-directory.js

@@ -0,0 +1,68 @@
+import { execFile } from 'node:child_process';
+import { access } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+export function resolveLocalStateDirectory(input) {
+    const configured_state_dir = input.override ?? process.env.SDLC_STATE_DIR;
+    if (configured_state_dir) {
+        return {
+            state_dir: resolve(configured_state_dir),
+            source: 'override',
+            warning: null
+        };
+    }
+    const state_dir = join(input.sidecar_dir ?? join(input.repository_root, '.sdlc'), 'state');
+    return {
+        state_dir,
+        source: 'default',
+        warning: `Repository-local SDLC state at ${state_dir} is ignored and can be removed by destructive cleanup such as git clean -fdx. Use SDLC_STATE_DIR for machine-level durability.`
+    };
+}
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch (error) {
+        const error_code = typeof error === 'object' && error !== null && 'code' in error
+            ? error.code
+            : null;
+        if (error_code === 'ENOENT' || error_code === 'ENOTDIR')
+            return false;
+        throw error;
+    }
+}
+async function assertDefaultStateIsIgnored(repository_root, state_dir) {
+    const relative_state_dir = `${state_dir
+        .slice(repository_root.length)
+        .replace(/^[/\\]+/, '')
+        .replace(/\\/g, '/')}/`;
+    try {
+        await execFileAsync('git', ['check-ignore', '--quiet', '--no-index', '--', relative_state_dir], { cwd: repository_root });
+    }
+    catch (error) {
+        const exit_code = typeof error === 'object' && error !== null && 'code' in error
+            ? error.code
+            : null;
+        if (exit_code === 1) {
+            throw new Error(`Refusing to create local SDLC control state because ${relative_state_dir} is not ignored by Git. Add the sidecar state path to .gitignore or set SDLC_STATE_DIR to an ignored private location.`);
+        }
+        throw error;
+    }
+}
+export async function prepareLocalStateDirectory(input) {
+    const resolution = resolveLocalStateDirectory(input);
+    if (resolution.source === 'override')
+        return resolution;
+    await assertDefaultStateIsIgnored(input.repository_root, resolution.state_dir);
+    const legacy_database_path = join(input.git_dir, 'sdlc', 'metadata.sqlite');
+    const current_database_path = join(resolution.state_dir, 'metadata.sqlite');
+    if (input.sidecar_dir === undefined &&
+        (await pathExists(legacy_database_path)) &&
+        !(await pathExists(current_database_path))) {
+        throw new Error(`Legacy SDLC state exists at ${join(input.git_dir, 'sdlc')}, but the new default is ${resolution.state_dir}. No state was moved automatically. Set SDLC_STATE_DIR to the legacy directory for this run, or use the forthcoming explicit state migration command before adopting the new default.`);
+    }
+    return resolution;
+}
+//# sourceMappingURL=state-directory.js.map

package/dist/local/state-directory.js.map

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

package/dist/local/store-database.d.ts

@@ -0,0 +1,13 @@
+declare const DatabaseSync: typeof import("node:sqlite").DatabaseSync;
+export type LocalStoreDatabase = InstanceType<typeof DatabaseSync>;
+/** metadata.sqlite's schema version and its feature, as features.json lists them. */
+export declare const LOCAL_STORE_VERSION = 1;
+export declare const LOCAL_STORE_FEATURE: {
+    feature: string;
+    stability: string;
+};
+/** The store's name in a refusal: its features.json path, never a filesystem path. */
+export declare const LOCAL_STORE_NAME = "{worktree}/.sdlc/state/metadata.sqlite";
+export declare function openLocalStoreDatabase(state_dir: string): Promise<LocalStoreDatabase>;
+export {};
+//# sourceMappingURL=store-database.d.ts.map

package/dist/local/store-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-database.d.ts","sourceRoot":"","sources":["../../src/local/store-database.ts"],"names":[],"mappings":"AAQA,QAAA,MAAQ,YAAY,2CAA2D,CAAC;AAEhF,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC;AAEnE,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,mBAAmB;;;CAA4C,CAAC;AAC7E,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,2CAA2C,CAAC;AA6HzE,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CA4B7B"}

package/dist/local/store-database.js

@@ -0,0 +1,187 @@
+import { chmod, mkdir } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { ownPackageName } from '../own-package.js';
+import { LocalStoreVersionError } from './operation.js';
+const require = createRequire(import.meta.url);
+const { DatabaseSync } = require('node:sqlite');
+/** metadata.sqlite's schema version and its feature, as features.json lists them. */
+export const LOCAL_STORE_VERSION = 1;
+export const LOCAL_STORE_FEATURE = { feature: 'graph', stability: 'stable' };
+/** The store's name in a refusal: its features.json path, never a filesystem path. */
+export const LOCAL_STORE_NAME = '{worktree}/.sdlc/state/metadata.sqlite';
+// A stamped store skips this on open: a change to it, or to the columns added
+// below, raises LOCAL_STORE_VERSION and migrates the version before it.
+const LOCAL_STORE_SCHEMA = `
+  create table if not exists local_session (
+    id text primary key,
+    worktree_id text not null,
+    status text not null check (status in ('active', 'closed')),
+    last_acknowledged_revision integer not null,
+    last_acknowledged_graph_hash text,
+    last_acknowledged_sync_revision integer,
+    last_acknowledged_sync_root_hash text,
+    base_checkpoint_id text,
+    created_at text not null,
+    updated_at text not null
+  );
+  create unique index if not exists one_active_local_session
+    on local_session(worktree_id) where status = 'active';
+  create table if not exists branch_binding (
+    source_ref text primary key,
+    branch_id text not null,
+    worktree_id text not null,
+    bound_at text not null
+  );
+  create table if not exists local_checkpoint (
+    id text primary key,
+    session_id text not null references local_session(id) on delete cascade,
+    revision integer not null,
+    graph_hash text not null,
+    object_hash text not null,
+    created_at text not null
+  );
+  create table if not exists pending_worktree_change (
+    id text primary key,
+    session_id text not null references local_session(id) on delete cascade,
+    idempotency_key text not null unique,
+    expected_revision integer not null,
+    request_hash text not null,
+    payload_json text not null,
+    transaction_id text,
+    checkpoint_id text not null references local_checkpoint(id),
+    graph_hash text not null,
+    status text not null check (status in ('pending', 'accepted')),
+    created_at text not null,
+    accepted_at text
+  );
+  create table if not exists superseded_worktree_change (
+    id text primary key,
+    session_id text not null references local_session(id) on delete cascade,
+    idempotency_key text not null,
+    expected_revision integer not null,
+    request_hash text not null,
+    payload_json text not null,
+    transaction_id text,
+    checkpoint_id text not null references local_checkpoint(id),
+    graph_hash text not null,
+    created_at text not null,
+    remote_revision integer not null,
+    remote_sync_revision integer not null,
+    remote_sync_root_hash text not null,
+    reason text not null,
+    superseded_at text not null
+  );
+  create table if not exists projection_state (
+    worktree_id text primary key,
+    projection_dir text not null,
+    base_revision integer not null,
+    base_graph_hash text not null,
+    materialized_at text not null,
+    updated_at text not null
+  );
+  create table if not exists projection_deletion_intent (
+    worktree_id text not null,
+    entity_kind text not null check (
+      entity_kind in ('node', 'edge', 'path', 'path_relation')
+    ),
+    entity_id text not null,
+    created_at text not null,
+    primary key (worktree_id, entity_kind, entity_id)
+  );
+  create table if not exists local_sync_manifest (
+    worktree_id text not null,
+    sync_revision integer not null,
+    sync_root_hash text not null,
+    manifest_json text not null,
+    created_at text not null,
+    primary key (worktree_id, sync_revision)
+  );
+  create index if not exists local_sync_manifest_by_root
+    on local_sync_manifest(worktree_id, sync_root_hash, sync_revision desc);
+`;
+function addMissingCompatibilityColumns(database) {
+    const local_session_columns = database
+        .prepare("pragma table_info('local_session')")
+        .all();
+    const local_session_column_names = new Set(local_session_columns.map((column) => column.name));
+    if (!local_session_column_names.has('last_acknowledged_sync_revision')) {
+        database.exec('alter table local_session add column last_acknowledged_sync_revision integer');
+    }
+    if (!local_session_column_names.has('last_acknowledged_sync_root_hash')) {
+        database.exec('alter table local_session add column last_acknowledged_sync_root_hash text');
+    }
+    const pending_change_columns = database
+        .prepare("pragma table_info('pending_worktree_change')")
+        .all();
+    if (!new Set(pending_change_columns.map((column) => column.name)).has('transaction_id')) {
+        database.exec('alter table pending_worktree_change add column transaction_id text');
+    }
+}
+export async function openLocalStoreDatabase(state_dir) {
+    await mkdir(state_dir, { recursive: true, mode: 0o700 });
+    await chmod(state_dir, 0o700);
+    for (const directory of ['objects', 'cache']) {
+        const path = join(state_dir, directory);
+        await mkdir(path, { recursive: true, mode: 0o700 });
+        await chmod(path, 0o700);
+    }
+    const database_path = join(state_dir, 'metadata.sqlite');
+    const database = new DatabaseSync(database_path);
+    try {
+        // The busy timeout writes nothing, so even the first read waits out a
+        // lock. The pragma, unlike the constructor's timeout option (Node
+        // 22.16), works on every Node 22 the package supports.
+        database.exec('PRAGMA busy_timeout = 5000');
+        // Before any other pragma or write: a store from newer code is never changed.
+        knownVersion(database);
+        await chmod(database_path, 0o600);
+        database.exec('PRAGMA journal_mode = WAL; PRAGMA foreign_keys = ON;');
+        // A stamped store has today's shape: open it without a write lock.
+        if (knownVersion(database) !== LOCAL_STORE_VERSION)
+            stamp(database);
+        return database;
+    }
+    catch (error) {
+        database.close();
+        throw error;
+    }
+}
+/** Under one write lock, gives an unversioned store today's shape and its version. */
+function stamp(database) {
+    database.exec('BEGIN IMMEDIATE');
+    try {
+        // Another process may have stamped it, or a newer one migrated it.
+        if (knownVersion(database) === 0) {
+            database.exec(LOCAL_STORE_SCHEMA);
+            addMissingCompatibilityColumns(database);
+            database.exec(`PRAGMA user_version = ${LOCAL_STORE_VERSION}`);
+        }
+        database.exec('COMMIT');
+    }
+    catch (error) {
+        // SQLite may already have rolled back (a full disk, an I/O error); the
+        // original error is the one to report.
+        try {
+            database.exec('ROLLBACK');
+        }
+        catch {
+            // no transaction left to roll back
+        }
+        throw error;
+    }
+}
+/** The store's version, 0 (unversioned) or current; any other refuses. */
+function knownVersion(database) {
+    const { user_version } = database.prepare('PRAGMA user_version').get();
+    if (user_version === 0 || user_version === LOCAL_STORE_VERSION)
+        return user_version;
+    throw new LocalStoreVersionError({
+        ...LOCAL_STORE_FEATURE,
+        store: LOCAL_STORE_NAME,
+        found: user_version,
+        expected: LOCAL_STORE_VERSION,
+        package: ownPackageName()
+    });
+}
+//# sourceMappingURL=store-database.js.map

package/dist/local/store-database.js.map

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

package/dist/local/store.d.ts

@@ -0,0 +1,181 @@
+export { resolveLocalStateDirectory } from './state-directory.js';
+export type LocalSession = {
+    id: string;
+    worktree_id: string;
+    status: 'active' | 'closed';
+    last_acknowledged_revision: number;
+    last_acknowledged_graph_hash: string | null;
+    last_acknowledged_sync_revision: number | null;
+    last_acknowledged_sync_root_hash: string | null;
+    base_checkpoint_id: string | null;
+    created_at: string;
+    updated_at: string;
+};
+export type PendingWorktreeChange = {
+    id: string;
+    session_id: string;
+    idempotency_key: string;
+    expected_revision: number;
+    request_hash: string;
+    payload_json: string;
+    transaction_id: string | null;
+    checkpoint_id: string;
+    graph_hash: string;
+    status: 'pending' | 'accepted';
+    created_at: string;
+    accepted_at: string | null;
+};
+export type SupersededWorktreeChange = Omit<PendingWorktreeChange, 'status' | 'accepted_at'> & {
+    remote_revision: number;
+    remote_sync_revision: number;
+    remote_sync_root_hash: string;
+    reason: 'remote_state_advanced_without_receipt' | 'remote_state_unchanged_without_receipt';
+    superseded_at: string;
+};
+export type LocalBranchBinding = {
+    source_ref: string;
+    branch_id: string;
+    worktree_id: string;
+    bound_at: string;
+};
+export type LocalProjectionState = {
+    worktree_id: string;
+    projection_dir: string;
+    base_revision: number;
+    base_graph_hash: string;
+    materialized_at: string;
+    updated_at: string;
+};
+export type LocalProjectionDeletionIntent = {
+    worktree_id: string;
+    entity_kind: 'node' | 'edge' | 'path' | 'path_relation';
+    entity_id: string;
+    created_at: string;
+};
+export type LocalSyncManifest = {
+    worktree_id: string;
+    sync_revision: number;
+    sync_root_hash: string;
+    manifest_json: string;
+    created_at: string;
+};
+export declare class LocalSdlcStore {
+    readonly state_dir: string;
+    readonly database_path: string;
+    private readonly database;
+    private constructor();
+    static open(state_dir: string): Promise<LocalSdlcStore>;
+    close(): void;
+    private runTransaction;
+    startSession(input: {
+        worktree_id: string;
+        revision: number;
+        graph_hash?: string | null;
+        sync_revision?: number | null;
+        sync_root_hash?: string | null;
+    }): LocalSession;
+    bindBranch(input: {
+        source_ref: string;
+        branch_id: string;
+        worktree_id: string;
+    }): LocalBranchBinding;
+    getBranchBinding(source_ref: string): LocalBranchBinding | null;
+    getActiveSession(worktree_id: string): LocalSession | null;
+    adoptAcknowledgedCheckpoint(input: {
+        session_id: string;
+        checkpoint_id: string;
+        revision: number;
+        graph_hash: string;
+        sync_revision?: number | null;
+        sync_root_hash?: string | null;
+    }): void;
+    adoptRemoteSyncState(input: {
+        session_id: string;
+        revision: number;
+        sync_revision: number;
+        sync_root_hash: string;
+    }): void;
+    getProjectionState(worktree_id: string): LocalProjectionState | null;
+    setProjectionState(input: {
+        worktree_id: string;
+        projection_dir: string;
+        base_revision: number;
+        base_graph_hash: string;
+    }): LocalProjectionState;
+    relocateProjectionState(input: {
+        worktree_id: string;
+        expected_projection_dir: string;
+        projection_dir: string;
+    }): LocalProjectionState;
+    recordProjectionDeletion(input: {
+        worktree_id: string;
+        entity_kind: LocalProjectionDeletionIntent['entity_kind'];
+        entity_id: string;
+    }): LocalProjectionDeletionIntent;
+    listProjectionDeletions(worktree_id: string): LocalProjectionDeletionIntent[];
+    clearProjectionDeletions(worktree_id: string): void;
+    private syncObjectPath;
+    hasSyncObject(object_hash: string): Promise<boolean>;
+    writeSyncObject(input: {
+        object_hash: string;
+        canonical_json: string;
+    }): Promise<void>;
+    readSyncObject(object_hash: string): Promise<string>;
+    writeSyncManifest(input: {
+        worktree_id: string;
+        sync_revision: number;
+        sync_root_hash: string;
+        manifest_json: string;
+        allow_revision_repair?: boolean;
+    }): LocalSyncManifest;
+    getSyncManifest(input: {
+        worktree_id: string;
+        sync_revision?: number;
+        sync_root_hash?: string;
+    }): LocalSyncManifest | null;
+    checkpoint(input: {
+        session_id: string;
+        revision: number;
+        graph_json: string;
+    }): Promise<{
+        checkpoint_id: string;
+        graph_hash: string;
+    }>;
+    enqueueChange(input: {
+        session_id: string;
+        expected_revision: number;
+        payload_json: string;
+        checkpoint_id: string;
+        graph_hash: string;
+        idempotency_key?: string;
+    }): PendingWorktreeChange;
+    setPendingChangeTransaction(input: {
+        change_id: string;
+        transaction_id: string;
+        previous_transaction_id?: string | null;
+    }): void;
+    acknowledgeChange(input: {
+        change_id: string;
+        resulting_revision: number;
+        graph_hash: string;
+        checkpoint_id: string;
+        sync_revision?: number | null;
+        sync_root_hash?: string | null;
+    }): void;
+    listPendingChanges(session_id: string): PendingWorktreeChange[];
+    hasPendingChanges(): boolean;
+    supersedePendingChangesAndAdoptCheckpoint(input: {
+        session_id: string;
+        expected_pending_change_ids: string[];
+        checkpoint_id: string;
+        revision: number;
+        graph_hash: string;
+        sync_revision: number;
+        sync_root_hash: string;
+        reason: SupersededWorktreeChange['reason'];
+    }): string[];
+    listSupersededChanges(session_id: string): SupersededWorktreeChange[];
+    readCheckpointObject(object_hash: string): Promise<string>;
+    readCheckpointGraph(checkpoint_id: string): Promise<string>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/local/store.d.ts.map

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