@software-dlc/cli 0.157.2

package/dist/local/health-store.js

@@ -0,0 +1,218 @@
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { HealthInspectionError } from './health-files.js';
+import { health_binding_schema, health_session_schema, health_pending_entry_schema } from './health-schema.js';
+import { checkOperation } from './operation.js';
+const require = createRequire(import.meta.url);
+const { DatabaseSync } = require('node:sqlite');
+const projection_schema = z
+    .object({
+    base_revision: z.number().int().nonnegative().safe(),
+    base_graph_hash: z.string().max(100)
+})
+    .strict();
+const projection_details_schema = z
+    .object({
+    projection_dir: z.string().min(1).max(4096),
+    base_revision: z.number().int().nonnegative().safe(),
+    base_graph_hash: z.string().regex(/^[0-9a-f]{64}$/),
+    checkpoint_hash: z
+        .string()
+        .regex(/^[0-9a-f]{64}$/)
+        .nullable(),
+    deletion_intents: z
+        .array(z
+        .object({
+        entity_kind: z.enum(['node', 'edge', 'path', 'path_relation']),
+        entity_id: z.string().uuid()
+    })
+        .strict())
+        .max(2000)
+})
+    .strict();
+const expected_columns = {
+    branch_binding: ['source_ref', 'branch_id', 'worktree_id', 'bound_at'],
+    local_session: [
+        'id',
+        'worktree_id',
+        'status',
+        'last_acknowledged_revision',
+        'last_acknowledged_graph_hash',
+        'last_acknowledged_sync_revision',
+        'last_acknowledged_sync_root_hash',
+        'base_checkpoint_id',
+        'created_at',
+        'updated_at'
+    ],
+    projection_state: [
+        'worktree_id',
+        'projection_dir',
+        'base_revision',
+        'base_graph_hash',
+        'materialized_at',
+        'updated_at'
+    ],
+    pending_worktree_change: [
+        'id',
+        'session_id',
+        'idempotency_key',
+        'expected_revision',
+        'request_hash',
+        'payload_json',
+        'transaction_id',
+        'checkpoint_id',
+        'graph_hash',
+        'status',
+        'created_at',
+        'accepted_at'
+    ]
+};
+/** A read transaction over an existing compatible store. No writable store handle escapes. */
+export async function inspectHealthStore(files, state_dir, source_ref, include_projection = false) {
+    const path = join(state_dir, 'metadata.sqlite');
+    if (!(await files.observe(path)))
+        return null;
+    await files.regular(path, 64 * 1024 * 1024);
+    for (const suffix of ['-wal', '-shm', '-journal'])
+        await files.observe(path + suffix);
+    // SQLite's readOnly flag does not prohibit WAL coordination-file writes.
+    // Inspect only the fixed header; never open a WAL database or ignore its WAL.
+    // https://sqlite.org/fileformat.html#the_database_header
+    const header = await files.readPrefix(path, 100, 64 * 1024 * 1024);
+    if (!header ||
+        header.length !== 100 ||
+        header.subarray(0, 16).toString('binary') !== 'SQLite format 3\0')
+        throw new HealthInspectionError('state_unavailable');
+    if (header[18] === 2 || header[19] === 2)
+        throw new HealthInspectionError('wal_inspection_unsupported');
+    if (header[18] !== 1 || header[19] !== 1)
+        throw new HealthInspectionError('schema_unsupported');
+    let database;
+    try {
+        checkOperation();
+        database = new DatabaseSync(path, { readOnly: true });
+        // Exclusive SQLite locking mode avoids creating shared-memory files. WAL may
+        // be unavailable: never use a writable or immutable fallback to make it work.
+        database.exec('PRAGMA locking_mode=EXCLUSIVE; PRAGMA query_only=ON; PRAGMA busy_timeout=0; BEGIN;');
+        const version = z
+            // 0 is a store no versioned writer opened yet; 1 is metadata.sqlite's version.
+            .object({ user_version: z.union([z.literal(0), z.literal(1)]) })
+            .safeParse(database.prepare('PRAGMA user_version').get());
+        if (!version.success)
+            throw new HealthInspectionError('schema_unsupported');
+        for (const [table, expected] of Object.entries(expected_columns)) {
+            const columns = z
+                .array(z.object({ name: z.string() }))
+                .parse(database.prepare(`PRAGMA table_info(${table})`).all());
+            if (columns
+                .map((x) => x.name)
+                .sort()
+                .join(',') !== [...expected].sort().join(','))
+                throw new HealthInspectionError('schema_unsupported');
+        }
+        checkOperation();
+        const raw_binding = source_ref
+            ? database
+                .prepare('SELECT source_ref, branch_id, worktree_id FROM branch_binding WHERE source_ref = ?')
+                .get(source_ref)
+            : undefined;
+        const binding = raw_binding
+            ? health_binding_schema.parse(raw_binding)
+            : null;
+        const raw_session = binding
+            ? database
+                .prepare("SELECT id, worktree_id, last_acknowledged_revision, last_acknowledged_graph_hash, last_acknowledged_sync_revision, last_acknowledged_sync_root_hash FROM local_session WHERE worktree_id = ? AND status = 'active'")
+                .get(binding.worktree_id)
+            : undefined;
+        const session = raw_session
+            ? health_session_schema.parse(raw_session)
+            : null;
+        const raw_projection = binding
+            ? database
+                .prepare('SELECT base_revision, base_graph_hash FROM projection_state WHERE worktree_id = ?')
+                .get(binding.worktree_id)
+            : undefined;
+        const projection = raw_projection
+            ? projection_schema.parse(raw_projection)
+            : null;
+        const pending_count = session
+            ? z
+                .object({ count: z.number().int().nonnegative().safe() })
+                .parse(database
+                .prepare("SELECT count(*) AS count FROM pending_worktree_change WHERE session_id = ? AND status = 'pending'")
+                .get(session.id)).count
+            : 0;
+        const entries = session
+            ? z
+                .array(health_pending_entry_schema)
+                .parse(database
+                .prepare("SELECT id, idempotency_key, transaction_id FROM pending_worktree_change WHERE session_id = ? AND status = 'pending' ORDER BY created_at, id LIMIT 20")
+                .all(session.id))
+            : [];
+        let projection_details = null;
+        let projection_error = null;
+        if (include_projection && binding && projection) {
+            try {
+                const location = z
+                    .object({ projection_dir: z.string().min(1).max(4096) })
+                    .parse(database
+                    .prepare('SELECT projection_dir FROM projection_state WHERE worktree_id = ?')
+                    .get(binding.worktree_id));
+                const checkpoint = session
+                    ? z
+                        .object({
+                        object_hash: z.string().regex(/^[0-9a-f]{64}$/),
+                        graph_hash: z.string().regex(/^[0-9a-f]{64}$/),
+                        revision: z.number().int().nonnegative()
+                    })
+                        .nullable()
+                        .parse(database
+                        .prepare('SELECT c.object_hash, c.graph_hash, c.revision FROM local_checkpoint c JOIN local_session s ON s.base_checkpoint_id = c.id AND s.id = c.session_id WHERE s.id = ?')
+                        .get(session.id) ?? null)
+                    : null;
+                const deletions = database
+                    .prepare('SELECT entity_kind, entity_id FROM projection_deletion_intent WHERE worktree_id = ? ORDER BY entity_kind, entity_id LIMIT 2001')
+                    .all(binding.worktree_id);
+                if (deletions.length > 2000)
+                    projection_error = 'projection_limit_exceeded';
+                else {
+                    const base_matches = checkpoint &&
+                        checkpoint.object_hash === checkpoint.graph_hash &&
+                        checkpoint.graph_hash === projection.base_graph_hash &&
+                        checkpoint.revision === projection.base_revision &&
+                        session?.last_acknowledged_revision === projection.base_revision &&
+                        session.last_acknowledged_graph_hash === projection.base_graph_hash;
+                    projection_details = projection_details_schema.parse({
+                        ...location,
+                        ...projection,
+                        checkpoint_hash: base_matches ? checkpoint.object_hash : null,
+                        deletion_intents: deletions
+                    });
+                }
+            }
+            catch {
+                projection_error = 'projection_base_unavailable';
+            }
+        }
+        checkOperation();
+        database.exec('ROLLBACK;');
+        return {
+            binding,
+            session,
+            projection,
+            projection_details,
+            projection_error,
+            pending: {
+                availability: 'known',
+                count: pending_count,
+                entries,
+                truncated: pending_count > entries.length
+            }
+        };
+    }
+    finally {
+        database?.close();
+    }
+}
+//# sourceMappingURL=health-store.js.map

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

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

package/dist/local/index.d.ts

@@ -0,0 +1,66 @@
+export * from './api-client.js';
+export * from './config.js';
+export * from './canonical.js';
+export * from './environment-context.js';
+export * from './environment-sidecar.js';
+export * from './environment-switch.js';
+export * from './external-worktree-binding.js';
+export * from './git.js';
+export * from './git-ref-authority.js';
+export * from './graph-sync.js';
+export * from './projection.js';
+export * from './rebuild.js';
+export * from './scope-impact.js';
+export * from './portable-commit.js';
+export * from './portable-commit-store.js';
+export * from './state-directory.js';
+export * from './store.js';
+export * from './sync.js';
+export * from './worktree-projection.js';
+export * from './workspace-store.js';
+export * from './workspace-topology.js';
+export * from './workspace-topology-runtime.js';
+export * from './workspace-history-store.js';
+export * from './workspace-history-types.js';
+export * from './workspace-handoff.js';
+export * from './workspace-merge.js';
+export * from './workspace-graph-store.js';
+export * from './workspace-authority.js';
+export * from './workspace-paths.js';
+export * from './workspace-prune.js';
+export * from './workspace-runtime.js';
+export * from './workspace-claim-status.js';
+export * from './workspace-claim-status-read.js';
+export * from './workspace-evidence.js';
+export * from './workspace-evidence-status.js';
+export * from './workspace-evidence-sign-tool.js';
+export * from './workspace-runtime-lease.js';
+export * from './workspace-runtime-handoff.js';
+export * from './workspace-resolution.js';
+export * from './workspace-resolver-provider.js';
+export * from './workspace-remote-provider.js';
+export * from './workspace-remote-fetch.js';
+export * from './workspace-remote-push.js';
+export * from './workspace-remote-topic.js';
+export * from './workspace-remote-topic-journal.js';
+export * from './workspace-remote-transfer.js';
+export * from './workspace-portable-authoring.js';
+export * from './workspace-scope.js';
+export * from './workspace-viewer-snapshot.js';
+export * from './workspace-viewer-server.js';
+export * from './read-operation.js';
+export * from './operation.js';
+export * from './media-upload.js';
+export * from './health-schema.js';
+export { inspectLocalHealth } from './health-inspection.js';
+export { applyHealthPolicy } from './health-policy.js';
+export * from './task-context-schema.js';
+export * from './task-context-observations.js';
+export { assembleTaskContext } from './task-context.js';
+export * from './ownership-reader-schema.js';
+export { readLocalOwnership } from './ownership-reader.js';
+export { readLocalTaskContext } from './task-context-provider.js';
+export { inspectTaskContext, task_context_inspection_options_schema } from './task-context-inspection.js';
+export { readLocalSourceEvidence } from './source-evidence/reader.js';
+export { source_mapping_schema, source_budget_schema, source_result_schema, SOURCE_READ_LIMITS, type SourceMapping, type SourceReadResult } from './source-evidence/schema.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/local/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,UAAU,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,qBAAqB,CAAC;AAEpC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,mBAAmB,CAAC;AAElC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EACL,kBAAkB,EAClB,sCAAsC,EACvC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAC"}

package/dist/local/index.js

@@ -0,0 +1,66 @@
+export * from './api-client.js';
+export * from './config.js';
+export * from './canonical.js';
+export * from './environment-context.js';
+export * from './environment-sidecar.js';
+export * from './environment-switch.js';
+export * from './external-worktree-binding.js';
+export * from './git.js';
+export * from './git-ref-authority.js';
+export * from './graph-sync.js';
+export * from './projection.js';
+export * from './rebuild.js';
+export * from './scope-impact.js';
+export * from './portable-commit.js';
+export * from './portable-commit-store.js';
+export * from './state-directory.js';
+export * from './store.js';
+export * from './sync.js';
+export * from './worktree-projection.js';
+export * from './workspace-store.js';
+export * from './workspace-topology.js';
+export * from './workspace-topology-runtime.js';
+export * from './workspace-history-store.js';
+export * from './workspace-history-types.js';
+export * from './workspace-handoff.js';
+export * from './workspace-merge.js';
+export * from './workspace-graph-store.js';
+export * from './workspace-authority.js';
+export * from './workspace-paths.js';
+export * from './workspace-prune.js';
+export * from './workspace-runtime.js';
+export * from './workspace-claim-status.js';
+export * from './workspace-claim-status-read.js';
+export * from './workspace-evidence.js';
+export * from './workspace-evidence-status.js';
+export * from './workspace-evidence-sign-tool.js';
+export * from './workspace-runtime-lease.js';
+export * from './workspace-runtime-handoff.js';
+export * from './workspace-resolution.js';
+export * from './workspace-resolver-provider.js';
+export * from './workspace-remote-provider.js';
+export * from './workspace-remote-fetch.js';
+export * from './workspace-remote-push.js';
+export * from './workspace-remote-topic.js';
+export * from './workspace-remote-topic-journal.js';
+export * from './workspace-remote-transfer.js';
+export * from './workspace-portable-authoring.js';
+export * from './workspace-scope.js';
+export * from './workspace-viewer-snapshot.js';
+export * from './workspace-viewer-server.js';
+export * from './read-operation.js';
+export * from './operation.js';
+export * from './media-upload.js';
+export * from './health-schema.js';
+export { inspectLocalHealth } from './health-inspection.js';
+export { applyHealthPolicy } from './health-policy.js';
+export * from './task-context-schema.js';
+export * from './task-context-observations.js';
+export { assembleTaskContext } from './task-context.js';
+export * from './ownership-reader-schema.js';
+export { readLocalOwnership } from './ownership-reader.js';
+export { readLocalTaskContext } from './task-context-provider.js';
+export { inspectTaskContext, task_context_inspection_options_schema } from './task-context-inspection.js';
+export { readLocalSourceEvidence } from './source-evidence/reader.js';
+export { source_mapping_schema, source_budget_schema, source_result_schema, SOURCE_READ_LIMITS } from './source-evidence/schema.js';
+//# sourceMappingURL=index.js.map

package/dist/local/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/local/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,UAAU,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,qBAAqB,CAAC;AAEpC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,mBAAmB,CAAC;AAElC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EACL,kBAAkB,EAClB,sCAAsC,EACvC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAGnB,MAAM,6BAA6B,CAAC"}

package/dist/local/journey-commands.d.ts

@@ -0,0 +1,65 @@
+export declare function listJourneys(input: {
+    projection_dir: string;
+}): Promise<{
+    version: number;
+    journeys: {
+        entry: string;
+        label: string;
+        stories: number;
+        loops: boolean;
+        branching: boolean;
+        truncated: boolean;
+    }[];
+    segments_without_entry: string[];
+    problems: import("@software-dlc/graph/validator").JourneyProblem[];
+}>;
+export declare function showJourney(input: {
+    projection_dir: string;
+    entry: string;
+}): Promise<{
+    version: number;
+    entry: string;
+    label: string;
+    stories: {
+        id: string;
+        label: string;
+    }[];
+    continuations: {
+        edge: string;
+        from_story: string;
+        end: string;
+        to_story: string;
+        start: string;
+    }[];
+    final_ends: {
+        id: string;
+        label: string;
+    }[];
+    loops: boolean;
+    branching: boolean;
+    routes: string[][];
+    truncated: boolean;
+}>;
+/**
+ * Sets the test's journey and links it to the stories it walks: every story of
+ * a journey without branching, or the entry plus `via` when it branches.
+ */
+export declare function linkJourneyTest(input: {
+    projection_dir: string;
+    node_id: string;
+    entry: string;
+    via?: string[];
+}): Promise<{
+    version: number;
+    test: string;
+    journey: string;
+    label: string;
+    journey_set: boolean;
+    stories: {
+        id: string;
+        label: string;
+        status: string;
+        edge_id: string;
+    }[];
+}>;
+//# sourceMappingURL=journey-commands.d.ts.map

package/dist/local/journey-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey-commands.d.ts","sourceRoot":"","sources":["../../src/local/journey-commands.ts"],"names":[],"mappings":"AA+CA,wBAAsB,YAAY,CAAC,KAAK,EAAE;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GAgBnE;AAcD,wBAAsB,WAAW,CAAC,KAAK,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;GAoBjF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;;;;;;;;;;;;GA8DA"}

package/dist/local/journey-commands.js

@@ -0,0 +1,138 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { buildJourneys, isJourneyWalk } from '@software-dlc/graph/validator';
+import { writeJsonAtomically } from './projection.js';
+import { linkTestNode } from './test-commands.js';
+/**
+ * `sdlc workspace journey` and `sdlc workspace test link --journey`: journeys
+ * read from a local workspace projection (docs/specs/story-journeys.md). A
+ * journey is derived from its entry story and `journey_continuation` edges, so
+ * these commands only read, except `link`, which sets a test's journey and adds
+ * `verifies` edges to the stories it walks. `sdlc workspace commit` validates.
+ */
+async function readEntities(directory) {
+    let names;
+    try {
+        names = await readdir(directory);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    return Promise.all(names
+        .filter((name) => name.endsWith('.json'))
+        .sort()
+        .map(async (name) => JSON.parse(await readFile(join(directory, name), 'utf8'))));
+}
+async function readProjection(projection_dir) {
+    const nodes = await readEntities(join(projection_dir, 'nodes'));
+    const edges = await readEntities(join(projection_dir, 'edges'));
+    return { nodes, edges, nodes_by_id: new Map(nodes.map((node) => [node.id, node])) };
+}
+const labelOf = (nodes_by_id, id) => nodes_by_id.get(id)?.data?.data?.label ?? id;
+export async function listJourneys(input) {
+    const { nodes, edges } = await readProjection(input.projection_dir);
+    const journeys = buildJourneys({ nodes, edges });
+    return {
+        version: 1,
+        journeys: journeys.journeys.map((journey) => ({
+            entry: journey.entry,
+            label: journey.label,
+            stories: journey.stories.length,
+            loops: journey.loops,
+            branching: journey.branching,
+            truncated: journey.truncated
+        })),
+        segments_without_entry: journeys.segments_without_entry,
+        problems: journeys.problems
+    };
+}
+function requireJourney(journeys, entry) {
+    const journey = journeys.journeys.find((candidate) => candidate.entry === entry);
+    if (!journey) {
+        throw new Error(`${entry} is not a journey entry. Entries: ${journeys.journeys.map((j) => `${j.entry} (${j.label})`).join(', ') || 'none'}.`);
+    }
+    return journey;
+}
+export async function showJourney(input) {
+    const { nodes, edges, nodes_by_id } = await readProjection(input.projection_dir);
+    const journeys = buildJourneys({ nodes, edges });
+    const journey = requireJourney(journeys, input.entry);
+    const label = (id) => labelOf(nodes_by_id, id);
+    return {
+        version: 1,
+        entry: journey.entry,
+        label: journey.label,
+        stories: journey.stories.map((id) => ({ id, label: label(id) })),
+        continuations: journey.continuations.map((edge) => {
+            const c = journeys.continuations.get(edge);
+            return { edge, from_story: c.from_story, end: c.end, to_story: c.to_story, start: c.start };
+        }),
+        final_ends: journey.final_ends.map((id) => ({ id, label: label(id) })),
+        loops: journey.loops,
+        branching: journey.branching,
+        routes: journey.routes.map((route) => route.map(label)),
+        truncated: journey.truncated
+    };
+}
+/**
+ * Sets the test's journey and links it to the stories it walks: every story of
+ * a journey without branching, or the entry plus `via` when it branches.
+ */
+export async function linkJourneyTest(input) {
+    const { nodes, edges, nodes_by_id } = await readProjection(input.projection_dir);
+    const test = nodes_by_id.get(input.node_id);
+    if (test?.type !== 'test') {
+        throw new Error(`Node ${input.node_id} is ${test ? `a ${test.type}` : 'not in this projection'}, not a test.`);
+    }
+    const journeys = buildJourneys({ nodes, edges });
+    const journey = requireJourney(journeys, input.entry);
+    const via = [...new Set(input.via ?? [])];
+    let stories;
+    if (via.length === 0) {
+        if (journey.branching) {
+            throw new Error(`Journey "${journey.label}" branches; name the stories the test walks with --via. Routes: ${journey.routes
+                .map((route) => route.map((id) => labelOf(nodes_by_id, id)).join(' > '))
+                .join(' | ')}`);
+        }
+        stories = journey.stories;
+    }
+    else {
+        stories = journey.stories.filter((id) => id === journey.entry || via.includes(id));
+        const unknown = via.filter((id) => !journey.stories.includes(id));
+        if (unknown.length > 0) {
+            throw new Error(`Not stories of journey "${journey.label}": ${unknown.join(', ')}.`);
+        }
+        if (!isJourneyWalk(journeys, journey, new Set(stories))) {
+            throw new Error(`The entry and --via stories are not one walk of journey "${journey.label}"; include every story between them.`);
+        }
+    }
+    // Link first and name the journey last, so a failure part way leaves verifies
+    // edges (kept on retry) but never a journey the test does not yet walk.
+    const links = [];
+    for (const story of stories) {
+        links.push(await linkTestNode({ projection_dir: input.projection_dir, node_id: input.node_id, target_id: story }));
+    }
+    const path = join(input.projection_dir, 'nodes', `${input.node_id}.json`);
+    const raw = JSON.parse(await readFile(path, 'utf8'));
+    const previous = raw.data.data.test?.journey;
+    if (previous !== journey.entry) {
+        raw.data.data.test = { ...raw.data.data.test, journey: journey.entry };
+        await writeJsonAtomically(path, raw);
+    }
+    return {
+        version: 1,
+        test: input.node_id,
+        journey: journey.entry,
+        label: journey.label,
+        journey_set: previous !== journey.entry,
+        stories: stories.map((id, index) => ({
+            id,
+            label: labelOf(nodes_by_id, id),
+            status: links[index].status,
+            edge_id: links[index].edge_id
+        }))
+    };
+}
+//# sourceMappingURL=journey-commands.js.map

package/dist/local/journey-commands.js.map

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

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

@@ -0,0 +1,46 @@
+import type { OrgMember, OrgPostHolder, OrgSlotOverride } from '@software-dlc/graph/computation';
+import type { LocalWorkspaceStoreDatabase } from './workspace-store-database.js';
+/**
+ * A local org's rows in the repository store (org-structure-and-access.md,
+ * Local org without an org connection): the root of its governance graph,
+ * an object in objects/, and who holds each post. The graph names the posts;
+ * holders are live data and never nodes.
+ */
+export type LocalOrgHolder = OrgPostHolder & {
+    held_since: string;
+};
+export declare class LocalOrgStore {
+    private readonly database;
+    constructor(database: LocalWorkspaceStoreDatabase);
+    /** The root hash of the org's governance graph, or null when it has none. */
+    root(org_id: string): string | null;
+    holders(org_id: string): LocalOrgHolder[];
+    /**
+     * Runs `run` in one write transaction, so a check of the graph's root and
+     * its holders and the change it allows cannot interleave with another
+     * writer's.
+     */
+    write<T>(run: () => T): T;
+    /**
+     * Points the org at a new graph root if its root is still `expected` (null:
+     * the org has no graph yet). Call it inside `write`.
+     */
+    setRoot(org_id: string, expected: string | null, root_hash: string): void;
+    /** Adds a holder; false when the member already holds the post. */
+    addHolder(org_id: string, holder: LocalOrgHolder): boolean;
+    /** The team id the org's one project names as its owner, or null when none is set. */
+    projectTeam(org_id: string): string | null;
+    setProjectTeam(org_id: string, team_id: string): void;
+    /** The project's slot overrides, one per slot, posts in id order. */
+    overrides(org_id: string): OrgSlotOverride[];
+    /** Replaces a slot's override with `override`. Call it inside `write`. */
+    setOverride(org_id: string, override: OrgSlotOverride & {
+        set_by: OrgMember;
+        set_at: string;
+    }): void;
+    /** Drops a slot's override; false when it had none. */
+    clearOverride(org_id: string, slot_id: string): boolean;
+    /** Removes a holder; false when the member did not hold the post. */
+    removeHolder(org_id: string, post_id: string, member: OrgMember): boolean;
+}
+//# sourceMappingURL=local-org-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-org-store.d.ts","sourceRoot":"","sources":["../../src/local/local-org-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,eAAe,EAChB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAkBpE,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,2BAA2B;IAElE,6EAA6E;IAC7E,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOnC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAgBzC;;;;OAIG;IACH,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;IAYzB;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAiBzE,mEAAmE;IACnE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO;IAkB1D,sFAAsF;IACtF,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO1C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAWrD,qEAAqE;IACrE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IA0B5C,0EAA0E;IAC1E,WAAW,CACT,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,GAAG;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAChE,IAAI;IAoBP,uDAAuD;IACvD,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IASvD,qEAAqE;IACrE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO;CAS1E"}