@software-dlc/cli 0.157.2

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

@@ -0,0 +1,726 @@
+import { chmod, mkdir } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+const require = createRequire(import.meta.url);
+const { DatabaseSync } = require('node:sqlite');
+const LOCAL_WORKSPACE_STORE_SCHEMA = `
+  create table if not exists local_repository (
+    singleton integer primary key check (singleton = 1),
+    repository_id text not null unique,
+    git_common_dir text not null unique,
+    schema_version integer not null check (schema_version = 1),
+    created_at text not null
+  );
+
+  create table if not exists local_workspace_ref (
+    ref_name text primary key,
+    head_commit_id text not null,
+    created_at text not null,
+    updated_at text not null
+  );
+
+  create table if not exists local_workspace (
+    id text primary key,
+    repository_id text not null,
+    source_workspace_id text references local_workspace(id),
+    actor_kind text not null check (actor_kind in ('human', 'ai')),
+    git_worktree_path text not null unique,
+    git_dir text not null unique,
+    git_common_dir text not null,
+    fork_git_commit_id text not null,
+    fork_sdlc_commit_id text not null,
+    head_sdlc_commit_id text not null,
+    attached_ref text references local_workspace_ref(ref_name),
+    status text not null check (status in ('active', 'closed')),
+    created_at text not null,
+    updated_at text not null
+  );
+
+  create table if not exists local_source_repository_binding (
+    git_common_dir text primary key,
+    repository_id text not null,
+    source_repository_association_id text not null,
+    remote_name text not null,
+    remote_url text not null,
+    remote_identity text not null,
+    moved_from_remote_identity text,
+    created_at text not null,
+    updated_at text not null
+  );
+
+  create index if not exists local_source_binding_by_association
+    on local_source_repository_binding(
+      repository_id, source_repository_association_id
+    );
+
+  create unique index if not exists one_workspace_per_attached_ref
+    on local_workspace(attached_ref)
+    where attached_ref is not null and status = 'active';
+
+  create index if not exists local_workspace_by_source
+    on local_workspace(source_workspace_id, created_at);
+
+  create table if not exists local_workspace_task_scope (
+    workspace_id text primary key references local_workspace(id),
+    scope_json text not null,
+    created_at text not null
+  );
+
+  create table if not exists local_workspace_deletion_intent (
+    workspace_id text not null references local_workspace(id),
+    entity_kind text not null
+      check (entity_kind in ('node', 'edge', 'path', 'path_relation')),
+    entity_id text not null,
+    recorded_at text not null,
+    primary key (workspace_id, entity_kind, entity_id)
+  );
+
+  create table if not exists local_workspace_commit (
+    id text primary key,
+    root_hash text not null,
+    parent_ids_json text not null,
+    author_workspace_id text not null references local_workspace(id),
+    message text not null,
+    validation_status text not null
+      check (validation_status in ('passed', 'failed')),
+    validation_evidence_json text not null,
+    created_at text not null
+  );
+
+  create index if not exists local_commit_by_author
+    on local_workspace_commit(author_workspace_id, created_at);
+
+  create table if not exists local_workspace_commit_source_context (
+    commit_id text primary key references local_workspace_commit(id),
+    source_repository_association_id text not null,
+    remote_identity text not null,
+    git_ref text,
+    git_head text not null,
+    evidence_scope_json text not null,
+    created_at text not null
+  );
+
+  create table if not exists portable_commit (
+    id text primary key,
+    commit_json text not null
+  );
+
+  create table if not exists local_commit_portable_mapping (
+    local_commit_id text primary key references local_workspace_commit(id),
+    portable_commit_id text not null references portable_commit(id),
+    attestation_json text not null
+  );
+
+  create index if not exists local_mapping_by_portable_commit
+    on local_commit_portable_mapping(portable_commit_id);
+
+  create table if not exists remote_tracking_ref (
+    remote_name text not null,
+    source_ref text not null,
+    tracking_ref text primary key,
+    commit_id text not null references portable_commit(id),
+    created_at text not null,
+    updated_at text not null,
+    unique (remote_name, source_ref)
+  );
+
+  create index if not exists remote_tracking_ref_by_remote
+    on remote_tracking_ref(remote_name, source_ref);
+
+  create table if not exists local_branch_association (
+    local_ref text primary key references local_workspace_ref(ref_name),
+    git_ref text not null unique,
+    upstream_remote_name text,
+    upstream_source_ref text,
+    upstream_tracking_ref text,
+    base_portable_commit_id text references portable_commit(id),
+    created_at text not null,
+    updated_at text not null,
+    check (
+      (upstream_remote_name is null and upstream_source_ref is null
+        and upstream_tracking_ref is null and base_portable_commit_id is null)
+      or
+      (upstream_remote_name is not null and upstream_source_ref is not null
+        and upstream_tracking_ref is not null
+        and base_portable_commit_id is not null)
+    )
+  );
+
+  create table if not exists remote_fetch_journal (
+    id text primary key,
+    remote_name text not null,
+    source_ref text not null,
+    tracking_ref text not null,
+    expected_old_commit_id text,
+    wanted_commit_id text not null,
+    haves_json text not null,
+    received_commit_ids_json text not null,
+    received_graph_roots_json text not null,
+    status text not null
+      check (status in ('planned', 'verified', 'completed', 'stale', 'failed')),
+    error_code text,
+    created_at text not null,
+    updated_at text not null
+  );
+
+  create index if not exists remote_fetch_journal_by_remote
+    on remote_fetch_journal(remote_name, created_at, id);
+
+  create table if not exists remote_push_journal (
+    id text primary key,
+    remote_name text not null,
+    destination_ref text not null,
+    expected_old_commit_id text not null,
+    new_commit_id text not null,
+    commit_ids_json text not null,
+    graph_roots_json text not null,
+    missing_commit_ids_json text not null,
+    missing_graph_roots_json text not null,
+    idempotency_key text not null unique,
+    status text not null
+      check (status in (
+        'planned', 'negotiated', 'uploaded', 'completed', 'stale',
+        'rejected', 'failed'
+      )),
+    error_code text,
+    current_remote_commit_id text,
+    created_at text not null,
+    updated_at text not null
+  );
+
+  create index if not exists remote_push_journal_by_remote
+    on remote_push_journal(remote_name, destination_ref, created_at, id);
+
+  create table if not exists remote_topic_branch_journal (
+    id text primary key,
+    remote_name text not null,
+    topic_ref text not null,
+    target_ref text not null,
+    expected_target_commit_id text not null,
+    new_commit_id text not null,
+    commit_ids_json text not null,
+    graph_roots_json text not null,
+    missing_commit_ids_json text not null,
+    missing_graph_roots_json text not null,
+    idempotency_key text not null unique,
+    status text not null
+      check (status in (
+        'planned', 'negotiated', 'uploaded', 'completed', 'stale',
+        'rejected', 'failed'
+      )),
+    error_code text,
+    current_target_commit_id text,
+    remote_branch_id text,
+    legacy_commit_id text,
+    created_at text not null,
+    updated_at text not null
+  );
+
+  create index if not exists remote_topic_branch_journal_by_remote
+    on remote_topic_branch_journal(remote_name, topic_ref, created_at, id);
+
+  create table if not exists remote_pull_request_journal (
+    id text primary key,
+    remote_name text not null,
+    source_ref text not null,
+    target_ref text not null,
+    expected_source_commit_id text not null,
+    expected_target_commit_id text not null,
+    title text not null,
+    description text,
+    idempotency_key text not null unique,
+    status text not null
+      check (status in ('planned', 'completed', 'stale', 'rejected')),
+    error_code text,
+    current_source_commit_id text,
+    current_target_commit_id text,
+    pull_request_id text,
+    created_at text not null,
+    updated_at text not null
+  );
+
+  create index if not exists remote_pull_request_journal_by_remote
+    on remote_pull_request_journal(remote_name, source_ref, created_at, id);
+
+  create table if not exists local_integration_queue (
+    id integer primary key autoincrement,
+    coordinator_workspace_id text not null references local_workspace(id),
+    child_workspace_id text not null references local_workspace(id),
+    child_commit_id text not null,
+    status text not null
+      check (status in (
+        'queued', 'integrated', 'blocked_conflict', 'blocked_validation'
+      )),
+    enqueued_at text not null,
+    updated_at text not null,
+    unique (coordinator_workspace_id, child_commit_id)
+  );
+
+  create index if not exists local_integration_queue_fifo
+    on local_integration_queue(coordinator_workspace_id, status, id);
+
+  create table if not exists local_integration_attempt (
+    id text primary key,
+    queue_entry_id integer not null references local_integration_queue(id),
+    merge_base_commit_id text not null,
+    expected_coordinator_commit_id text not null,
+    child_commit_id text not null,
+    base_root_hash text not null,
+    coordinator_root_hash text not null,
+    child_root_hash text not null,
+    candidate_commit_id text references local_workspace_commit(id),
+    status text not null
+      check (status in (
+        'integrated', 'stale_head', 'blocked_conflict', 'blocked_validation'
+      )),
+    conflict_json text not null,
+    validation_json text not null,
+    created_at text not null
+  );
+
+  create index if not exists local_integration_attempt_by_queue
+    on local_integration_attempt(queue_entry_id, created_at);
+
+  create table if not exists local_resolution_attempt (
+    id text primary key,
+    queue_entry_id integer not null references local_integration_queue(id),
+    attempt_number integer not null,
+    status text not null
+      check (status in (
+        'resolved', 'rejected_output', 'provider_error', 'timed_out',
+        'budget_exceeded'
+      )),
+    provider_json text not null,
+    prompt_contract_version text not null,
+    conflict_json text not null,
+    dependency_json text not null,
+    context_bytes integer not null,
+    elapsed_ms integer not null,
+    output_hash text,
+    validation_json text not null,
+    candidate_root_hash text,
+    resulting_commit_id text references local_workspace_commit(id),
+    created_at text not null
+  );
+
+  create index if not exists local_resolution_attempt_by_queue
+    on local_resolution_attempt(queue_entry_id, created_at, id);
+
+  create table if not exists local_reconciliation_attempt (
+    id text primary key,
+    child_workspace_id text not null references local_workspace(id),
+    source_workspace_id text not null references local_workspace(id),
+    expected_child_commit_id text not null,
+    expected_source_commit_id text not null,
+    merge_base_commit_id text not null,
+    base_root_hash text not null,
+    child_root_hash text not null,
+    source_root_hash text not null,
+    candidate_commit_id text references local_workspace_commit(id),
+    status text not null
+      check (status in (
+        'reconciled', 'stale_head', 'blocked_conflict', 'blocked_validation'
+      )),
+    conflict_json text not null,
+    validation_json text not null,
+    created_at text not null
+  );
+
+  create index if not exists local_reconciliation_by_child
+    on local_reconciliation_attempt(child_workspace_id, created_at);
+
+  create table if not exists local_reconciliation_resolution_attempt (
+    id text primary key,
+    reconciliation_attempt_id text not null
+      references local_reconciliation_attempt(id),
+    attempt_number integer not null,
+    status text not null
+      check (status in (
+        'resolved', 'rejected_output', 'provider_error', 'timed_out',
+        'budget_exceeded'
+      )),
+    provider_json text not null,
+    prompt_contract_version text not null,
+    conflict_json text not null,
+    dependency_json text not null,
+    context_bytes integer not null,
+    elapsed_ms integer not null,
+    output_hash text,
+    validation_json text not null,
+    candidate_root_hash text,
+    resulting_commit_id text references local_workspace_commit(id),
+    created_at text not null
+  );
+
+  create index if not exists local_reconciliation_resolution_by_attempt
+    on local_reconciliation_resolution_attempt(
+      reconciliation_attempt_id, created_at, id
+    );
+
+  create table if not exists local_branch_integration_attempt (
+    id text primary key,
+    workspace_id text not null references local_workspace(id),
+    local_ref text not null references local_workspace_ref(ref_name),
+    tracking_ref text not null,
+    expected_local_commit_id text not null,
+    expected_upstream_commit_id text not null,
+    merge_base_commit_id text not null,
+    base_root_hash text not null,
+    local_root_hash text not null,
+    upstream_root_hash text not null,
+    candidate_commit_id text references local_workspace_commit(id),
+    resulting_head_commit_id text,
+    status text not null
+      check (status in (
+        'already_integrated', 'fast_forwarded', 'merged', 'stale_head',
+        'blocked_conflict',
+        'blocked_validation'
+      )),
+    conflict_json text not null,
+    validation_json text not null,
+    created_at text not null
+  );
+
+  create index if not exists local_branch_integration_by_ref
+    on local_branch_integration_attempt(local_ref, created_at, id);
+
+  create table if not exists local_branch_integration_resolution_attempt (
+    id text primary key,
+    branch_integration_attempt_id text not null
+      references local_branch_integration_attempt(id),
+    attempt_number integer not null,
+    status text not null
+      check (status in (
+        'resolved', 'rejected_output', 'provider_error', 'timed_out',
+        'budget_exceeded'
+      )),
+    provider_json text not null,
+    prompt_contract_version text not null,
+    conflict_json text not null,
+    dependency_json text not null,
+    context_bytes integer not null,
+    elapsed_ms integer not null,
+    output_hash text,
+    validation_json text not null,
+    candidate_root_hash text,
+    resulting_commit_id text references local_workspace_commit(id),
+    created_at text not null
+  );
+
+  create index if not exists local_branch_integration_resolution_by_attempt
+    on local_branch_integration_resolution_attempt(
+      branch_integration_attempt_id, created_at, id
+    );
+
+  create table if not exists local_branch_integration_revert_attempt (
+    id text primary key,
+    branch_integration_attempt_id text not null
+      references local_branch_integration_attempt(id),
+    workspace_id text not null references local_workspace(id),
+    local_ref text not null references local_workspace_ref(ref_name),
+    expected_head_commit_id text not null,
+    observed_head_commit_id text not null,
+    target_commit_id text not null,
+    revert_commit_id text references local_workspace_commit(id),
+    status text not null check (status in ('reverted', 'stale_head')),
+    validation_json text not null,
+    created_at text not null
+  );
+
+  create index if not exists local_branch_integration_revert_by_ref
+    on local_branch_integration_revert_attempt(local_ref, created_at, id);
+
+  create unique index if not exists one_successful_branch_integration_revert
+    on local_branch_integration_revert_attempt(branch_integration_attempt_id)
+    where status = 'reverted';
+
+  create table if not exists local_handoff (
+    id text primary key,
+    source_workspace_id text not null references local_workspace(id),
+    source_commit_id text not null,
+    child_workspace_id text not null references local_workspace(id),
+    child_commit_id text not null references local_workspace_commit(id),
+    created_at text not null,
+    unique (
+      source_workspace_id, source_commit_id,
+      child_workspace_id, child_commit_id
+    )
+  );
+
+  create table if not exists local_handoff_attempt (
+    id text primary key,
+    handoff_id text not null references local_handoff(id),
+    status text not null check (status in ('applied', 'stale_base')),
+    observed_source_commit_id text not null,
+    observed_child_commit_id text not null,
+    created_at text not null
+  );
+
+  create unique index if not exists one_applied_handoff
+    on local_handoff_attempt(handoff_id)
+    where status = 'applied';
+
+  create table if not exists graph_decision (
+    id text primary key,
+    coordinator_workspace_id text not null references local_workspace(id),
+    base_commit_id text not null,
+    question text not null,
+    criteria_json text not null,
+    evaluations_json text not null,
+    decider text not null,
+    status text not null
+      check (status in ('open', 'selected', 'landed', 'closed', 'abandoned')),
+    reason text,
+    landed_commit_id text,
+    created_at text not null,
+    updated_at text not null
+  );
+
+  create table if not exists decision_candidate (
+    decision_id text not null references graph_decision(id),
+    workspace_id text not null references local_workspace(id),
+    label text,
+    base_commit_id text not null,
+    status text not null
+      check (status in (
+        'candidate', 'selected', 'rejected', 'abandoned', 'detached',
+        'superseded'
+      )),
+    reason text,
+    attached_at text not null,
+    updated_at text not null,
+    primary key (decision_id, workspace_id)
+  );
+
+  create index if not exists decision_candidate_by_workspace
+    on decision_candidate(workspace_id, status);
+
+  create table if not exists decision_selection (
+    id text primary key,
+    decision_id text not null references graph_decision(id),
+    digest text not null,
+    winner_workspace_id text not null references local_workspace(id),
+    parts_json text not null,
+    reason text not null,
+    status text not null check (status in ('current', 'superseded')),
+    superseded_reason text,
+    created_at text not null
+  );
+
+  create unique index if not exists one_current_decision_selection
+    on decision_selection(decision_id)
+    where status = 'current';
+
+  create table if not exists local_pick_receipt (
+    id text primary key,
+    target_workspace_id text not null references local_workspace(id),
+    target_commit_before text not null,
+    target_commit_after text not null unique,
+    source_workspace_id text not null references local_workspace(id),
+    source_commit_id text not null,
+    merge_base_commit_id text not null,
+    selection_hash text not null,
+    result_root_hash text not null,
+    picked_json text not null,
+    dependency_additions_json text not null,
+    skipped_json text not null,
+    created_at text not null
+  );
+
+  create index if not exists local_pick_receipt_by_target
+    on local_pick_receipt(target_workspace_id, created_at);
+
+  create table if not exists local_integration_queue_gate (
+    queue_entry_id integer primary key
+      references local_integration_queue(id),
+    gate text not null check (gate in ('plan', 'design'))
+  );
+
+  create table if not exists local_workspace_pending_claim (
+    coordinator_workspace_id text not null references local_workspace(id),
+    entity_kind text not null
+      check (entity_kind in ('node', 'edge', 'path', 'path_relation')),
+    entity_id text not null,
+    work_stream_workspace_id text not null references local_workspace(id),
+    gate text not null check (gate in ('plan', 'design')),
+    change text not null check (change in ('added', 'changed', 'removal')),
+    built_commit_id text,
+    gate_commit_id text not null,
+    recorded_at text not null,
+    built_content text,
+    built_content_commit_id text,
+    gate_content text,
+    gate_content_commit_id text,
+    primary key (
+      coordinator_workspace_id, entity_kind, entity_id,
+      work_stream_workspace_id
+    )
+  );
+
+  create table if not exists local_vocabulary_admission (
+    singleton integer primary key check (singleton = 1),
+    origin text not null,
+    capabilities_json text not null,
+    evidence text not null,
+    recorded_at text not null
+  );
+
+  -- A local org (org-structure-and-access.md, Local org without an org
+  -- connection): its governance graph is an object in objects/ named here, and
+  -- who holds each post is live data beside it.
+  create table if not exists local_governance_graph (
+    org_id text primary key,
+    root_hash text not null,
+    updated_at text not null
+  );
+
+  create table if not exists local_org_post_holder (
+    org_id text not null references local_governance_graph(org_id),
+    post_id text not null,
+    member_kind text not null check (member_kind in ('person', 'agent')),
+    member_id text not null,
+    held_since text not null,
+    primary key (org_id, post_id, member_kind, member_id)
+  );
+
+  -- The repository is its local org's one project (osa-slots): the team that
+  -- owns it, and its hand-set slot bindings, one row per post an override
+  -- names. Slot and post ids are the governance graph's node ids.
+  create table if not exists local_org_project (
+    org_id text primary key references local_governance_graph(org_id),
+    team_id text not null,
+    set_at text not null
+  );
+
+  create table if not exists local_org_slot_binding (
+    org_id text not null references local_governance_graph(org_id),
+    slot_id text not null,
+    post_id text not null,
+    reason text not null,
+    set_by_kind text not null check (set_by_kind in ('person', 'agent')),
+    set_by_id text not null,
+    set_at text not null,
+    primary key (org_id, slot_id, post_id)
+  );
+`;
+/**
+ * Stores made before pending claims kept their content gain the columns
+ * empty; sdlc integrate fills them (workspace-built-content.ts). Each content
+ * column has a column naming the commit it was read at.
+ */
+function addPendingClaimContent(database) {
+    const missing = () => {
+        const columns = new Set(database
+            .prepare("pragma table_info('local_workspace_pending_claim')")
+            .all().map((column) => column.name));
+        return [
+            'built_content',
+            'built_content_commit_id',
+            'gate_content',
+            'gate_content_commit_id'
+        ].filter((column) => !columns.has(column));
+    };
+    if (missing().length === 0)
+        return;
+    // Another process may add them first: check again under the write lock.
+    database.exec('begin immediate');
+    try {
+        for (const column of missing()) {
+            database.exec(`alter table local_workspace_pending_claim add column ${column} text`);
+        }
+        database.exec('commit');
+    }
+    catch (error) {
+        database.exec('rollback');
+        throw error;
+    }
+}
+/**
+ * Stores made before a binding could move remotes gain the identity it moved
+ * from, empty (workspace-topology.ts topologyBindingMatch).
+ */
+function addBindingMovedFrom(database) {
+    const missing = () => !database
+        .prepare("pragma table_info('local_source_repository_binding')")
+        .all().some((column) => column.name === 'moved_from_remote_identity');
+    if (!missing())
+        return;
+    // Another process may add it first: check again under the write lock.
+    database.exec('begin immediate');
+    try {
+        if (missing()) {
+            database.exec('alter table local_source_repository_binding add column moved_from_remote_identity text');
+        }
+        database.exec('commit');
+    }
+    catch (error) {
+        database.exec('rollback');
+        throw error;
+    }
+}
+function migratePortableHandoffEndpoints(database) {
+    const foreign_keys = database
+        .prepare("pragma foreign_key_list('local_handoff')")
+        .all();
+    if (!foreign_keys.some((entry) => entry.table === 'local_workspace_commit' &&
+        entry.from === 'child_commit_id')) {
+        return;
+    }
+    database.exec('pragma foreign_keys = off; begin immediate;');
+    try {
+        database.exec(`
+      drop index if exists one_applied_handoff;
+      alter table local_handoff_attempt rename to local_handoff_attempt_legacy;
+      alter table local_handoff rename to local_handoff_legacy;
+      create table local_handoff (
+        id text primary key,
+        source_workspace_id text not null references local_workspace(id),
+        source_commit_id text not null,
+        child_workspace_id text not null references local_workspace(id),
+        child_commit_id text not null,
+        created_at text not null,
+        unique (
+          source_workspace_id, source_commit_id,
+          child_workspace_id, child_commit_id
+        )
+      );
+      create table local_handoff_attempt (
+        id text primary key,
+        handoff_id text not null references local_handoff(id),
+        status text not null check (status in ('applied', 'stale_base')),
+        observed_source_commit_id text not null,
+        observed_child_commit_id text not null,
+        created_at text not null
+      );
+      insert into local_handoff select * from local_handoff_legacy;
+      insert into local_handoff_attempt select * from local_handoff_attempt_legacy;
+      drop table local_handoff_attempt_legacy;
+      drop table local_handoff_legacy;
+      create unique index one_applied_handoff
+        on local_handoff_attempt(handoff_id)
+        where status = 'applied';
+      commit;
+    `);
+    }
+    catch (error) {
+        database.exec('rollback;');
+        throw error;
+    }
+    finally {
+        database.exec('pragma foreign_keys = on;');
+    }
+}
+export async function openLocalWorkspaceStoreDatabase(state_dir) {
+    await mkdir(state_dir, { recursive: true, mode: 0o700 });
+    await chmod(state_dir, 0o700);
+    const database_path = join(state_dir, 'repository.sqlite');
+    const database = new DatabaseSync(database_path);
+    await chmod(database_path, 0o600);
+    database.exec('PRAGMA journal_mode = WAL; PRAGMA foreign_keys = ON; PRAGMA busy_timeout = 5000;');
+    database.exec(LOCAL_WORKSPACE_STORE_SCHEMA);
+    migratePortableHandoffEndpoints(database);
+    addPendingClaimContent(database);
+    addBindingMovedFrom(database);
+    return database;
+}
+//# sourceMappingURL=workspace-store-database.js.map