@schnick371/devsteps-shared 1.1.0-next.4 → 2.0.0-next.1

package/dist/core/index-refs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-refs.d.ts","sourceRoot":"","sources":["../../src/core/index-refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAalG,cAAc,sBAAsB,CAAC;AAMrC;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAS5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,QAAQ,EACf,MAAM,CAAC,EAAE,UAAU,EACnB,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,IAAI,CA2BN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,UAAU,EACtB,SAAS,CAAC,EAAE,UAAU,EACtB,WAAW,CAAC,EAAE,kBAAkB,EAChC,WAAW,CAAC,EAAE,kBAAkB,GAC/B,IAAI,CAYN;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG;IACpD,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,UAAU,CAAC,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;IAClG,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAIA"}
+{"version":3,"file":"index-refs.d.ts","sourceRoot":"","sources":["../../src/core/index-refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAelG,cAAc,sBAAsB,CAAC;AAMrC;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAkB5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,QAAQ,EACf,MAAM,CAAC,EAAE,UAAU,EACnB,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,IAAI,CA4DN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,UAAU,EACtB,SAAS,CAAC,EAAE,UAAU,EACtB,WAAW,CAAC,EAAE,kBAAkB,EAChC,WAAW,CAAC,EAAE,kBAAkB,GAC/B,IAAI,CA0BN;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAQ7F;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,GACb,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,IAAI,CAON;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG;IACpD,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,UAAU,CAAC,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;IAClG,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAIA"}

package/dist/core/index-refs.js

@@ -12,7 +12,7 @@
  */
 import { existsSync, readFileSync } from 'node:fs';
 import { INDEX_FILENAMES } from '../types/index-refs.types.js';
-import { getIndexPaths, loadIndexByPriority, loadIndexByStatus, loadIndexByType, updateIndexByPriority, updateIndexByStatus, updateIndexByType, } from './index-refs-core.js';
+import { getIndexPaths, loadIndexByPriority, loadIndexByStatus, loadIndexByType, loadTagIndex, updateIndexByPriority, updateIndexByStatus, updateIndexByType, updateTagIndex, } from './index-refs-core.js';
 // Re-export all core I/O primitives for backward compatibility
 export * from './index-refs-core.js';
 //=============================================================================
@@ -101,6 +101,47 @@ export function updateItemInIndex(devstepsDir, itemId, oldStatus, newStatus, old
     }
 }
 //=============================================================================
+// TAG INDEX SYNCHRONIZATION
+//=============================================================================
+/**
+ * Add an item to each of the provided tag indexes.
+ */
+export function addItemToTagIndexes(devstepsDir, itemId, tags) {
+    for (const tag of tags) {
+        const ids = loadTagIndex(devstepsDir, tag);
+        if (!ids.includes(itemId)) {
+            ids.push(itemId);
+            updateTagIndex(devstepsDir, tag, ids);
+        }
+    }
+}
+/**
+ * Remove an item from each of the provided tag indexes.
+ */
+export function removeItemFromTagIndexes(devstepsDir, itemId, tags) {
+    for (const tag of tags) {
+        const ids = loadTagIndex(devstepsDir, tag);
+        const filtered = ids.filter((id) => id !== itemId);
+        if (filtered.length !== ids.length) {
+            updateTagIndex(devstepsDir, tag, filtered);
+        }
+    }
+}
+/**
+ * Diff old/new tag lists and update indexes accordingly.
+ * Adds item to indexes for newly added tags; removes from indexes for removed tags.
+ */
+export function updateItemTagIndexes(devstepsDir, itemId, oldTags, newTags) {
+    const oldSet = new Set(oldTags);
+    const newSet = new Set(newTags);
+    const added = newTags.filter((t) => !oldSet.has(t));
+    const removed = oldTags.filter((t) => !newSet.has(t));
+    if (added.length > 0)
+        addItemToTagIndexes(devstepsDir, itemId, added);
+    if (removed.length > 0)
+        removeItemFromTagIndexes(devstepsDir, itemId, removed);
+}
+//=============================================================================
 // BACKWARD COMPATIBILITY
 //=============================================================================
 /**

package/dist/core/index-refs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index-refs.js","sourceRoot":"","sources":["../../src/core/index-refs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index-refs.js","sourceRoot":"","sources":["../../src/core/index-refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,+DAA+D;AAC/D,cAAc,sBAAsB,CAAC;AAErC,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,IAAkB;IACpE,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACjC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,iBAAiB,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACnC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,aAAa,GAAG,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACxE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACrC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,qBAAqB,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,MAAc,EACd,IAAe,EACf,MAAmB,EACnB,QAA6B;IAE7B,IAAI,IAAI,EAAE,CAAC;QACT,iBAAiB,CACf,WAAW,EACX,IAAI,EACJ,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CACjE,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAe,EAAE,CAAC;YAChE,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAC9C,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,iBAAiB,CACf,WAAW,EACX,CAAC,EACD,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CACpC,CAAC;gBACF,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,mBAAmB,CACjB,WAAW,EACX,MAAM,EACN,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CACrE,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAiB,EAAE,CAAC;YACpE,MAAM,KAAK,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAChD,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,mBAAmB,CACjB,WAAW,EACX,CAAC,EACD,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CACpC,CAAC;gBACF,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,qBAAqB,CACnB,WAAW,EACX,QAAQ,EACR,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CACzE,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAyB,EAAE,CAAC;YAC9E,MAAM,KAAK,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAClD,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,qBAAqB,CACnB,WAAW,EACX,CAAC,EACD,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CACpC,CAAC;gBACF,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAAmB,EACnB,MAAc,EACd,SAAsB,EACtB,SAAsB,EACtB,WAAgC,EAChC,WAAgC;IAEhC,IAAI,SAAS,IAAI,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACtD,mBAAmB,CACjB,WAAW,EACX,SAAS,EACT,iBAAiB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CACxE,CAAC;QACF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC3D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,mBAAmB,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,IAAI,WAAW,IAAI,WAAW,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;QAC9D,qBAAqB,CACnB,WAAW,EACX,WAAW,EACX,mBAAmB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CAC5E,CAAC;QACF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC/D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,qBAAqB,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,MAAc,EAAE,IAAc;IACrF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjB,cAAc,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,WAAmB,EACnB,MAAc,EACd,IAAc;IAEd,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QACnD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;YACnC,cAAc,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,MAAc,EACd,OAAiB,EACjB,OAAiB;IAEjB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACjF,CAAC;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IAIjD,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC9E,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/core/index.d.ts

@@ -1,22 +1,104 @@
 /**
- * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
  * Licensed under the Apache License, Version 2.0
  *
  * Core module barrel export
  * Re-exports all public operations from the shared core layer.
  */
+export { assertCodexMcpArguments } from '../utils/codex-mcp-input.js';
+export { resolvePackagedCodexDir } from '../utils/codex-payload.js';
+export type { CodexMode, CodexOptions } from '../utils/codex-types.js';
 export { type AddItemArgs, type AddItemResult, addItem } from './add.js';
+export { type AddBatchArgs, type AddBatchEntry, type AddBatchPartial, AddBatchPartialError, type AddBatchPhase, type AddBatchResult, addBatch, } from './add-batch.js';
 export { type ArchiveItemResult, archiveItem, type PurgeItemsArgs, type PurgeItemsResult, purgeItems, } from './archive.js';
-export { type AutoMigrationOptions, checkMigrationNeeded, ensureFullMigration, ensureIndexMigrated, getMigrationStatusMessage, type MigrationCheckResult, type MigrationStats, migrateItemsDirectory, needsItemsDirectoryMigration, performMigration, } from './auto-migrate.js';
+export { type AutoMigrationOptions, checkMigrationNeeded, ensureFullMigration, ensureIndexMigrated, type FlatItem, type FolderMigrationResult, getMigrationStatusMessage, listFlatItems, MIGRATION_LOCK_FILE, type MigrationCheckResult, type MigrationProgress, type MigrationStats, migrateItemFolders, migrateItemsDirectory, needsIndexRemoval, needsItemFolderMigration, needsItemsDirectoryMigration, removeTrackedIndexes, withMigrationLock, } from './auto-migrate.js';
+export { type BoardItem, type BoardResult, getBoard } from './board.js';
 export { type BulkUpdateResult, bulkAddTags, bulkRemoveTags, bulkUpdateItems, } from './bulk-update.js';
-export { getConfig } from './config.js';
-export { analyzePackages, buildContextMeta, type ContextMeta, estimateTokens, formatContextAsText, generateProjectMd, getItemCounts, getQuickContext, getRecentUpdates, getStandardContext, readProjectMd, } from './context.js';
+export * from './child-relations.js';
+export * from './classification-exports.js';
+export * from './closeout-branch-record.js';
+export * from './closeout-classify.js';
+export * from './closeout-git.js';
+export * from './closeout-handover-draft.js';
+export * from './closeout-inventory.js';
+export * from './closeout-preserve.js';
+export * from './closeout-record-write.js';
+export * from './closeout-rescue.js';
+export * from './closeout-rescue-run.js';
+export * from './closeout-secrets.js';
+export * from './closeout-types.js';
+export * from './commit-hint.js';
+export * from './compass.js';
+export * from './compass-render.js';
+export * from './compass-types.js';
+export { assertValidAuthor, assertValidConfig, getConfig } from './config.js';
+export { analyzePackages, buildContextMeta, type ContextMeta, type ContextResponse, estimateTokens, getQuickContext, getStandardContext, type PackageInfo, readProjectMd, } from './context.js';
+export { type ActiveItemSummary, collectKeyPaths, getActiveItemsSummary, getItemCounts, getRecentUpdates, type ItemCounts, loadContextItems, } from './context-items.js';
+export { formatContextAsText, generateProjectMd } from './context-render.js';
+export * from './coord-handover-notice.js';
+export * from './coord-input.js';
+export * from './coord-read.js';
+export * from './coord-store.js';
+export * from './coord-summary.js';
+export * from './coord-sweep.js';
+export * from './coord-write.js';
+export { type CoordinationFinding, type CoordinationFindingKind, coordinationTextWarning, detectAddedCoordinationText, detectCoordinationText, HANDOVER_TAG, handoverTagWarning, isWorkItemType, projectSlugFromDevstepsDir, } from './coordination-text.js';
+export { CounterLockError, type CounterLockErrorCode, type CounterLockOrphan, type CounterLockOwner, type CounterLockStatus, counterLockStatus, recoverCounterLock, } from './counter-lock.js';
+export { type CountersUpdateResult, deriveCounters, getCountersPath, highestIdOnDisk, ItemReservationError, type ItemReservationFailure, type ItemReservationRequest, type ItemReservationResult, initializeCounters, loadCounters, reserveItemFolders, updateCounters, } from './counters.js';
+export { type ArchivedWorkItems, buildDashboardInsights, DASHBOARD_ACTIVITY_LIMIT, DASHBOARD_EPIC_LIMIT, DASHBOARD_WORK_TYPES, type DashboardInsights, type EpicProgressRow, OPEN_SERIES_DAYS, type OpenSeriesPoint, type OpenSummary, projectDashboardInsights, projectEpicProgress, projectOpenSeries, readArchivedWorkItems, type WeeklyOpenRow, } from './dashboard-insights.js';
+export { type Bounded, buildDashboardOverview, DASHBOARD_LIST_LIMIT, DASHBOARD_NEXT_UP_LIMIT, DASHBOARD_PATH_LIMIT, DASHBOARD_TRACE_HIT_LIMIT, type DashboardItem, type DashboardItems, type DashboardModelOptions, type DashboardOverview, findDashboardItems, nowLaneIds, projectDashboardOverview, QUADRANT_OF, type QuadrantKey, readDashboardItems, searchDashboardItems, } from './dashboard-model.js';
+export * from './decision-count.js';
+export * from './decision-question.js';
+export * from './decision-question-status.js';
+export * from './decision-round.js';
+export * from './decision-round-actions.js';
+export * from './decision-round-text.js';
+export * from './decision-round-types.js';
+export * from './description-patch.js';
+export { type AssembleOptions, type AssembleResult, assembleDocument, CircularBOMError, MissingDocItemsError, PathTraversalError, } from './docs-assemble.js';
+export { appendDocsMapNode, patchDocsMapNodeItems, readDocsMap, rebuildDocsMapShadow, removeDocsMapNode, upsertDocsMapNode, writeDocsMap, } from './docs-map.js';
+export { type CheckResult, type CheckStatus, type CheckSummary, runIntegrityChecks, summarizeChecks, } from './doctor.js';
+export { type GeneratedFileCandidate, type GeneratedFilesRepairResult, repairGeneratedFiles, } from './doctor-generated-files.js';
+export { detectPlaceholderCandidates } from './doctor-placeholders.js';
+export { repairItemSchema, type SchemaRepairChange, type SchemaRepairField, type SchemaRepairResult, type SchemaRepairSet, } from './doctor-schema-repair.js';
+export * from './epic-sections.js';
+export { buildProjectExport, type ExportFormat, type ExportProjectArgs, type ExportProjectResult, parseExportFormat, } from './export.js';
+export { type ExportItem, type ExportProject, type ExportStats, renderExportHtml, renderExportMarkdown, } from './export-render.js';
+export { clearFocusState, type FocusState, focusStateSchema, getFocusWipCount, loadFocusState, writeFocusState, } from './focus.js';
+export { WIP_LIMIT } from './focus-work.js';
+export { type DocFrontmatter, DocFrontmatterSchema, extractFrontmatter, type FrontmatterResult, type FrontmatterWarning, } from './frontmatter.js';
 export { type GetItemResult, getItem } from './get.js';
-export { type RebuildOptions, type RebuildResult, rebuildIndex, } from './index-rebuild.js';
-export * from './index-refs.js';
-export { type ListItemsArgs, type ListItemsResult, listItems } from './list.js';
+export * from './get-fields.js';
+export * from './guide-step-list.js';
+export { type ClassificationResult, DIATAXIS_TYPES, type DiataxisType, type HeuristicContext, heuristicClassify, MIXED_THRESHOLD, type ScoreVector, SUBHEADING_RATIO_THRESHOLD, TABLE_RATIO_THRESHOLD, } from './heuristic-classify.js';
+export { type AgentHost, buildHostEntry, entryMatches, type HostEntry, hostConfigPath, hostServersKey, mergeHostDocument, mergeHostEntry, type ServerRuntime, UNMANAGED_SELECTION, } from './host-config.js';
+export { applyClaudeSettings, type ClaudeSettingsOptions, type ClaudeSettingsResult, DEFAULT_SUBAGENT_MODEL, declareClaudePlugin, type HostSetupFile, type HostSetupOptions, type HostSetupResult, PLUGIN_ID, PLUGIN_MARKETPLACE, PLUGIN_REPOSITORY, resolveServerRuntime, SUBAGENT_MODEL_ENV_VAR, setupHost, } from './host-setup.js';
+export { importExcerpt } from './import-excerpt.js';
+export { commitImportSession, type ImportCommitOptions } from './import-materialize.js';
+export { type ClassifiedEntry, createSession, findActiveSession, generateSessionToken, type ImportSession, type ImportSessionFile, type ImportSessionStatus, isSessionExpired, readSession, type SplitEntry, validateSession, validateSessionToken, withSessionLock, writeSession, } from './import-session.js';
+export { importSourceHash } from './import-source.js';
+export { appendGitignoreEntries, DEVSTEPS_RUNTIME_IGNORES, type InitProjectOptions, type InitProjectResult, initProject, ProjectAlreadyInitializedError, } from './init-project.js';
+export { type AddAttachmentOptions, type AddAttachmentResult, AttachmentError, type AttachmentErrorCode, addAttachmentContent, attachmentFilePath, importAttachmentFile, MAX_ATTACHMENT_BYTES, MAX_ATTACHMENT_NAME, type RemoveAttachmentResult, type RenameAttachmentResult, removeAttachment, renameAttachment, uniqueAttachmentName, validateAttachmentName, } from './item-attachments.js';
+export { archivedItemPaths, archivedTypeDirectory, claimItemFolder, type ItemAttachment, type ItemPaths, isCanonicalItemFile, itemPaths, listAttachments, listItemFolders, typeDirectory, } from './item-paths.js';
+export { inspectRawItem, type RawItemInspection } from './item-raw.js';
+export { assertItemUnchanged, configureItemStore, DESCRIPTION_RETENTION_LIMIT, type ExpectedItemStamps, type FileStamp, type ItemStoreStats, invalidateItem, invalidateStore, itemStoreStats, listItemIds, type ReadAllItemsResult, readAllItemMetadata, readAllItems, readItem, readItemMetadata, StaleItemError, type StoredItem, type StoredItemMetadata, writeItemDescription, writeItemMetadata, } from './item-store.js';
+export { assertValidItemMetadata, describeZodIssues, type FieldOrigins, ItemValidationError, } from './item-validation.js';
 export { type LinkItemArgs, type LinkItemResult, linkItem } from './link.js';
+export { hasProcessDefinition, type ListItemEntry, type ListItemsArgs, type ListItemsResult, listItems, } from './list.js';
+export { CLOSED_STATUSES, LIST_DEFAULT_LIMIT, type ListOmitted, type ListPage, listItemsPage, } from './list-page.js';
+export { validateWorkspacePath } from './path-guard.js';
+export * from './process-definition-hint.js';
+export { getProjectStatus, type ProjectStatus, type ProjectStatusArgs, type RecentUpdate, STALE_AFTER_DAYS, type StaleItem, type StatusBreakdown, staleInProgress, } from './project-status.js';
+export { type PromoteResult, promoteItem } from './promote.js';
+export { evaluateRelationshipCompleteness, type RelationshipCompletenessResult, } from './relationship-completeness.js';
+export { INVERSE_RELATIONS } from './relationship-map.js';
+export { buildSearchMatcher, SEARCH_DEFAULT_LIMIT, type SearchHit, type SearchItemsArgs, type SearchItemsResult, type SearchMatchType, searchItems, } from './search.js';
+export { type TraceDiagnostic, type TraceDirection, type TraceEdge, type TraceNode, type TraceOptions, type TraceResult, traceRelationships, } from './trace.js';
+export { buildTraceabilityNarrative, type NarrativeDiagnostic, type NarrativeEvidence, type NarrativeItem, type TraceabilityNarrative, type TraceabilityNarrativeOptions, } from './traceability-narrative.js';
 export { type UnlinkItemArgs, type UnlinkItemResult, unlinkItem, } from './unlink.js';
-export { type UpdateItemArgs, type UpdateItemResult, updateItem } from './update.js';
+export { type AddCommitReferencesResult, addCommitReferences, type UpdateItemArgs, type UpdateItemOptions, type UpdateItemResult, updateItem, } from './update.js';
+export * from './update-reminders.js';
 export { type ValidationResult, validateRelationConflict, validateRelationship, type WorkItem, } from './validation.js';
+export * from './workflow-exports.js';
+export * from './write-diagnostics.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EACL,KAAK,iBAAiB,EACtB,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,gBAAgB,EACrB,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,WAAW,EAChB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,aAAa,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEvD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EACL,KAAK,gBAAgB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,KAAK,QAAQ,GACd,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"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"}

package/dist/core/index.js

@@ -1,25 +1,105 @@
 /**
- * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
  * Licensed under the Apache License, Version 2.0
  *
  * Core module barrel export
  * Re-exports all public operations from the shared core layer.
  */
+export { assertCodexMcpArguments } from '../utils/codex-mcp-input.js';
+// Agent host configuration
+export { resolvePackagedCodexDir } from '../utils/codex-payload.js';
 export { addItem } from './add.js';
+export { AddBatchPartialError, addBatch, } from './add-batch.js';
 export { archiveItem, purgeItems, } from './archive.js';
 // Auto-migration for external projects
-export { checkMigrationNeeded, ensureFullMigration, ensureIndexMigrated, getMigrationStatusMessage, migrateItemsDirectory, needsItemsDirectoryMigration, performMigration, } from './auto-migrate.js';
+export { checkMigrationNeeded, ensureFullMigration, ensureIndexMigrated, getMigrationStatusMessage, listFlatItems, MIGRATION_LOCK_FILE, migrateItemFolders, migrateItemsDirectory, needsIndexRemoval, needsItemFolderMigration, needsItemsDirectoryMigration, removeTrackedIndexes, withMigrationLock, } from './auto-migrate.js';
+export { getBoard } from './board.js';
 export { bulkAddTags, bulkRemoveTags, bulkUpdateItems, } from './bulk-update.js';
-export { getConfig } from './config.js';
-export { analyzePackages, buildContextMeta, estimateTokens, formatContextAsText, generateProjectMd, getItemCounts, getQuickContext, getRecentUpdates, getStandardContext, readProjectMd, } from './context.js';
+export * from './child-relations.js';
+export * from './classification-exports.js';
+export * from './closeout-branch-record.js';
+export * from './closeout-classify.js';
+export * from './closeout-git.js';
+export * from './closeout-handover-draft.js';
+export * from './closeout-inventory.js';
+export * from './closeout-preserve.js';
+export * from './closeout-record-write.js';
+export * from './closeout-rescue.js';
+export * from './closeout-rescue-run.js';
+export * from './closeout-secrets.js';
+export * from './closeout-types.js';
+export * from './commit-hint.js';
+export * from './compass.js';
+export * from './compass-render.js';
+export * from './compass-types.js';
+export { assertValidAuthor, assertValidConfig, getConfig } from './config.js';
+export { analyzePackages, buildContextMeta, estimateTokens, getQuickContext, getStandardContext, readProjectMd, } from './context.js';
+export { collectKeyPaths, getActiveItemsSummary, getItemCounts, getRecentUpdates, loadContextItems, } from './context-items.js';
+export { formatContextAsText, generateProjectMd } from './context-render.js';
+export * from './coord-handover-notice.js';
+export * from './coord-input.js';
+export * from './coord-read.js';
+export * from './coord-store.js';
+export * from './coord-summary.js';
+export * from './coord-sweep.js';
+export * from './coord-write.js';
+export { coordinationTextWarning, detectAddedCoordinationText, detectCoordinationText, HANDOVER_TAG, handoverTagWarning, isWorkItemType, projectSlugFromDevstepsDir, } from './coordination-text.js';
+export { CounterLockError, counterLockStatus, recoverCounterLock, } from './counter-lock.js';
+export { deriveCounters, getCountersPath, highestIdOnDisk, ItemReservationError, initializeCounters, loadCounters, reserveItemFolders, updateCounters, } from './counters.js';
+export { buildDashboardInsights, DASHBOARD_ACTIVITY_LIMIT, DASHBOARD_EPIC_LIMIT, DASHBOARD_WORK_TYPES, OPEN_SERIES_DAYS, projectDashboardInsights, projectEpicProgress, projectOpenSeries, readArchivedWorkItems, } from './dashboard-insights.js';
+export { buildDashboardOverview, DASHBOARD_LIST_LIMIT, DASHBOARD_NEXT_UP_LIMIT, DASHBOARD_PATH_LIMIT, DASHBOARD_TRACE_HIT_LIMIT, findDashboardItems, nowLaneIds, projectDashboardOverview, QUADRANT_OF, readDashboardItems, searchDashboardItems, } from './dashboard-model.js';
+export * from './decision-count.js';
+export * from './decision-question.js';
+export * from './decision-question-status.js';
+export * from './decision-round.js';
+export * from './decision-round-actions.js';
+export * from './decision-round-text.js';
+export * from './decision-round-types.js';
+export * from './description-patch.js';
+export { assembleDocument, CircularBOMError, MissingDocItemsError, PathTraversalError, } from './docs-assemble.js';
+export { appendDocsMapNode, patchDocsMapNodeItems, readDocsMap, rebuildDocsMapShadow, removeDocsMapNode, upsertDocsMapNode, writeDocsMap, } from './docs-map.js';
+export { runIntegrityChecks, summarizeChecks, } from './doctor.js';
+export { repairGeneratedFiles, } from './doctor-generated-files.js';
+export { detectPlaceholderCandidates } from './doctor-placeholders.js';
+export { repairItemSchema, } from './doctor-schema-repair.js';
+export * from './epic-sections.js';
+export { buildProjectExport, parseExportFormat, } from './export.js';
+export { renderExportHtml, renderExportMarkdown, } from './export-render.js';
+export { clearFocusState, focusStateSchema, getFocusWipCount, loadFocusState, writeFocusState, } from './focus.js';
+export { WIP_LIMIT } from './focus-work.js';
+export { DocFrontmatterSchema, extractFrontmatter, } from './frontmatter.js';
 export { getItem } from './get.js';
-// Index rebuild operations
-export { rebuildIndex, } from './index-rebuild.js';
-// Refs-style index operations
-export * from './index-refs.js';
-export { listItems } from './list.js';
+export * from './get-fields.js';
+export * from './guide-step-list.js';
+export { DIATAXIS_TYPES, heuristicClassify, MIXED_THRESHOLD, SUBHEADING_RATIO_THRESHOLD, TABLE_RATIO_THRESHOLD, } from './heuristic-classify.js';
+export { buildHostEntry, entryMatches, hostConfigPath, hostServersKey, mergeHostDocument, mergeHostEntry, UNMANAGED_SELECTION, } from './host-config.js';
+export { applyClaudeSettings, DEFAULT_SUBAGENT_MODEL, declareClaudePlugin, PLUGIN_ID, PLUGIN_MARKETPLACE, PLUGIN_REPOSITORY, resolveServerRuntime, SUBAGENT_MODEL_ENV_VAR, setupHost, } from './host-setup.js';
+export { importExcerpt } from './import-excerpt.js';
+export { commitImportSession } from './import-materialize.js';
+export { createSession, findActiveSession, generateSessionToken, isSessionExpired, readSession, validateSession, validateSessionToken, withSessionLock, writeSession, } from './import-session.js';
+export { importSourceHash } from './import-source.js';
+export { appendGitignoreEntries, DEVSTEPS_RUNTIME_IGNORES, initProject, ProjectAlreadyInitializedError, } from './init-project.js';
+export { AttachmentError, addAttachmentContent, attachmentFilePath, importAttachmentFile, MAX_ATTACHMENT_BYTES, MAX_ATTACHMENT_NAME, removeAttachment, renameAttachment, uniqueAttachmentName, validateAttachmentName, } from './item-attachments.js';
+export { archivedItemPaths, archivedTypeDirectory, claimItemFolder, isCanonicalItemFile, itemPaths, listAttachments, listItemFolders, typeDirectory, } from './item-paths.js';
+export { inspectRawItem } from './item-raw.js';
+export { assertItemUnchanged, configureItemStore, DESCRIPTION_RETENTION_LIMIT, invalidateItem, invalidateStore, itemStoreStats, listItemIds, readAllItemMetadata, readAllItems, readItem, readItemMetadata, StaleItemError, writeItemDescription, writeItemMetadata, } from './item-store.js';
+export { assertValidItemMetadata, describeZodIssues, ItemValidationError, } from './item-validation.js';
 export { linkItem } from './link.js';
+export { hasProcessDefinition, listItems, } from './list.js';
+export { CLOSED_STATUSES, LIST_DEFAULT_LIMIT, listItemsPage, } from './list-page.js';
+export { validateWorkspacePath } from './path-guard.js';
+export * from './process-definition-hint.js';
+export { getProjectStatus, STALE_AFTER_DAYS, staleInProgress, } from './project-status.js';
+export { promoteItem } from './promote.js';
+export { evaluateRelationshipCompleteness, } from './relationship-completeness.js';
+export { INVERSE_RELATIONS } from './relationship-map.js';
+export { buildSearchMatcher, SEARCH_DEFAULT_LIMIT, searchItems, } from './search.js';
+export { traceRelationships, } from './trace.js';
+export { buildTraceabilityNarrative, } from './traceability-narrative.js';
 export { unlinkItem, } from './unlink.js';
-export { updateItem } from './update.js';
+export { addCommitReferences, updateItem, } from './update.js';
+export * from './update-reminders.js';
 export { validateRelationConflict, validateRelationship, } from './validation.js';
+export * from './workflow-exports.js';
+export * from './write-diagnostics.js';
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAwC,OAAO,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAEL,WAAW,EAGX,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,uCAAuC;AACvC,OAAO,EAEL,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EAGzB,qBAAqB,EACrB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,eAAe,EACf,gBAAgB,EAEhB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAsB,OAAO,EAAE,MAAM,UAAU,CAAC;AACvD,2BAA2B;AAC3B,OAAO,EAGL,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,8BAA8B;AAC9B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAA4C,SAAS,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAA0C,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAGL,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAA8C,UAAU,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAEL,wBAAwB,EACxB,oBAAoB,GAErB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"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"}

package/dist/core/init-project.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Initialize a DevSteps project: the `.devsteps` structure, its `.gitignore`
+ * entries, and the customization surface of the selected agent host.
+ *
+ * The CLI and the MCP server used to carry their own copies of this sequence and
+ * drifted: the MCP copy resolved its package root outside the bundle and wrote
+ * neither `CLAUDE.md` nor the `.github` tree. Both adapters now call this module
+ * and only format its result.
+ *
+ * @see STORY-407 BUG-124 TASK-792 TASK-793 TASK-794
+ */
+import type { DevStepsConfig, Methodology } from '../schemas/index.js';
+import { type CodexMode } from '../utils/codex-types.js';
+import type { ContractFileResult } from '../utils/contract-block.js';
+import { type CopiedGithubFiles } from '../utils/init-helpers.js';
+import type { AgentHostSelection, UpdateAgentFilesResult } from '../utils/update-agent-files.js';
+/**
+ * Runtime state a DevSteps project writes but does not version. The backlog
+ * itself — items, indexes, config — is committed with the code, as the contract
+ * block tells every agent to do. Nothing creates `analysis/` or `events/` any
+ * more (STORY-478); their entries stay so that older projects keep those
+ * folders out of git.
+ */
+export declare const DEVSTEPS_RUNTIME_IGNORES: readonly ['.devsteps/analysis/', '.devsteps/events/', '.devsteps/backups/', '.devsteps/import-sessions/', '.devsteps/focus.json', '.devsteps/.mcp-port', '.devsteps/migration.lock', '.devsteps/index/counters.lock/', '.devsteps/index/.counters-lock.*.candidate/', '.devsteps/index/.counters-lock.*.retired/', '.devsteps/index/.counters-lock.*.quarantine/'];
+export interface InitProjectOptions {
+    codexMode?: CodexMode;
+    sourceCodexDir?: string;
+    dryRun?: boolean;
+    projectPath: string;
+    projectName: string;
+    packageVersion: string;
+    /** Packaged `.github` payload; undefined when the installation ships none. */
+    sourceGithubDir: string | undefined;
+    author?: string;
+    gitIntegration?: boolean;
+    methodology?: Methodology;
+    doneBy?: 'product-owner' | 'acceptance';
+    host?: AgentHostSelection;
+}
+export interface InitProjectResult {
+    codex?: UpdateAgentFilesResult;
+    devstepsDir: string;
+    config: DevStepsConfig;
+    host: AgentHostSelection;
+    /** Copilot `.github` tree written, or null when the host excludes Copilot. */
+    copilot: CopiedGithubFiles | null;
+    /** Claude contract outcome, or null when the host excludes Claude Code. */
+    claudeContract: ContractFileResult | null;
+    /** True when a selected host needed the packaged payload and none was found. */
+    payloadMissing: boolean;
+    /** `.gitignore` lines appended by this run. */
+    gitignoreAdded: string[];
+    warnings?: string[];
+}
+/** Thrown when the target already carries a `.devsteps` directory. */
+export declare class ProjectAlreadyInitializedError extends Error {
+    readonly devstepsDir: string;
+    constructor(devstepsDir: string);
+}
+export declare function initProject(options: InitProjectOptions): InitProjectResult;
+/**
+ * Append the entries a `.gitignore` does not already carry as a line of its own.
+ * Existing rules are never rewritten. Returns the lines that were appended.
+ */
+export declare function appendGitignoreEntries(gitignorePath: string, entries: readonly string[]): string[];
+//# sourceMappingURL=init-project.d.ts.map

package/dist/core/init-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-project.d.ts","sourceRoot":"","sources":["../../src/core/init-project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvE,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EAAE,KAAK,iBAAiB,EAAiC,MAAM,0BAA0B,CAAC;AAEjG,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAIjG;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,YACnC,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,gCAAgC,EAChC,6CAA6C,EAC7C,2CAA2C,EAC3C,8CAA8C,CACtC,CAAC;AAEX,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,eAAe,GAAG,YAAY,CAAC;IACxC,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,kBAAkB,CAAC;IACzB,8EAA8E;IAC9E,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,2EAA2E;IAC3E,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C,gFAAgF;IAChF,cAAc,EAAE,OAAO,CAAC;IACxB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,sEAAsE;AACtE,qBAAa,8BAA+B,SAAQ,KAAK;aAC3B,WAAW,EAAE,MAAM;IAA/C,YAA4B,WAAW,EAAE,MAAM,EAG9C;CACF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAsD1E;AAiFD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,MAAM,EAAE,CAYV"}

package/dist/core/init-project.js

@@ -0,0 +1,177 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Initialize a DevSteps project: the `.devsteps` structure, its `.gitignore`
+ * entries, and the customization surface of the selected agent host.
+ *
+ * The CLI and the MCP server used to carry their own copies of this sequence and
+ * drifted: the MCP copy resolved its package root outside the bundle and wrote
+ * neither `CLAUDE.md` nor the `.github` tree. Both adapters now call this module
+ * and only format its result.
+ *
+ * @see STORY-407 BUG-124 TASK-792 TASK-793 TASK-794
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { writeClaudeContractBlock } from '../utils/claude-host.js';
+import { setupCodexProject } from '../utils/codex-setup.js';
+import { hasOnlyCodexSnapshots } from '../utils/codex-state.js';
+import { assertCodexOptions } from '../utils/codex-types.js';
+import { getCurrentTimestamp, getMethodologyConfig, getTypePrefix } from '../utils/index.js';
+import { copyGithubFiles, writeSetupMd } from '../utils/init-helpers.js';
+import { assertSafeDirectory, assertSafeFile } from '../utils/snapshot-paths.js';
+import { assertValidAuthor, assertValidConfig } from './config.js';
+import { initializeCounters } from './counters.js';
+/**
+ * Runtime state a DevSteps project writes but does not version. The backlog
+ * itself — items, indexes, config — is committed with the code, as the contract
+ * block tells every agent to do. Nothing creates `analysis/` or `events/` any
+ * more (STORY-478); their entries stay so that older projects keep those
+ * folders out of git.
+ */
+export const DEVSTEPS_RUNTIME_IGNORES = [
+    '.devsteps/analysis/',
+    '.devsteps/events/',
+    '.devsteps/backups/',
+    '.devsteps/import-sessions/',
+    '.devsteps/focus.json',
+    '.devsteps/.mcp-port',
+    '.devsteps/migration.lock',
+    '.devsteps/index/counters.lock/',
+    '.devsteps/index/.counters-lock.*.candidate/',
+    '.devsteps/index/.counters-lock.*.retired/',
+    '.devsteps/index/.counters-lock.*.quarantine/',
+];
+/** Thrown when the target already carries a `.devsteps` directory. */
+export class ProjectAlreadyInitializedError extends Error {
+    devstepsDir;
+    constructor(devstepsDir) {
+        super('Project already initialized. Use devsteps status to view project info.');
+        this.devstepsDir = devstepsDir;
+        this.name = 'ProjectAlreadyInitializedError';
+    }
+}
+export function initProject(options) {
+    // STORY-382: reject an invalid author before any directory is created, so a
+    // failed init leaves nothing half-built behind.
+    assertValidAuthor(options.author, 'settings.default_author');
+    assertCodexOptions(options.host ?? 'copilot', options);
+    if (options.host !== 'codex' && options.dryRun !== undefined)
+        throw new Error('Init dry-run requires the codex host.');
+    const devstepsDir = join(options.projectPath, '.devsteps');
+    if (existsSync(devstepsDir) &&
+        (options.host !== 'codex' || !hasOnlyCodexSnapshots(devstepsDir))) {
+        throw new ProjectAlreadyInitializedError(devstepsDir);
+    }
+    const methodology = options.methodology ?? 'scrum';
+    const methodologyConfig = getMethodologyConfig(methodology);
+    const config = initialProjectConfig(options);
+    assertValidConfig(config);
+    assertSafeDirectory(devstepsDir, true);
+    const codex = initializeCodex(options, devstepsDir);
+    if (options.dryRun)
+        return {
+            devstepsDir,
+            config,
+            host: options.host ?? 'copilot',
+            copilot: null,
+            claudeContract: null,
+            payloadMissing: false,
+            gitignoreAdded: [],
+            codex,
+        };
+    mkdirSync(devstepsDir, { recursive: true });
+    for (const dir of methodologyConfig.directories)
+        mkdirSync(join(devstepsDir, dir), { recursive: true });
+    writeFileSync(join(devstepsDir, 'config.json'), JSON.stringify(config, null, 2));
+    const counters = {};
+    for (const type of methodologyConfig.item_types)
+        counters[getTypePrefix(type)] = 0;
+    const counterSetup = initializeCounters(devstepsDir, counters);
+    const gitignoreAdded = appendGitignoreEntries(join(options.projectPath, '.gitignore'), DEVSTEPS_RUNTIME_IGNORES);
+    writeSetupMd(options.projectName, devstepsDir);
+    return {
+        devstepsDir,
+        config,
+        gitignoreAdded,
+        ...(codex ? { codex } : {}),
+        ...(counterSetup.warnings.length > 0 ? { warnings: counterSetup.warnings } : {}),
+        ...writeHostPayload(options),
+    };
+}
+function initialProjectConfig(options) {
+    const methodology = options.methodology ?? 'scrum';
+    const methodologyConfig = getMethodologyConfig(methodology);
+    return {
+        version: options.packageVersion,
+        project_name: options.projectName,
+        project_id: `devsteps-${Date.now()}`,
+        created: getCurrentTimestamp(),
+        updated: getCurrentTimestamp(),
+        settings: {
+            methodology,
+            auto_increment: true,
+            git_integration: options.gitIntegration ?? true,
+            default_author: options.author,
+            ...(options.doneBy !== undefined ? { done_by: options.doneBy } : {}),
+            item_types: methodologyConfig.item_types,
+            item_prefixes: methodologyConfig.item_prefixes,
+            box_wip_limit: 10,
+        },
+    };
+}
+function initializeCodex(options, devstepsDir) {
+    if (options.host !== 'codex')
+        return undefined;
+    const ignore = join(options.projectPath, '.gitignore');
+    assertSafeFile(ignore, true);
+    const result = setupCodexProject(options.projectPath, devstepsDir, options, [ignore]);
+    if (!result.success)
+        throw new Error(`${result.message} ${result.error}`);
+    return result;
+}
+/**
+ * The Copilot host receives the `.github` tree; Claude Code receives its agents,
+ * commands, and skills from the DevSteps plugin, so only the contract block is
+ * anchored in `CLAUDE.md`.
+ */
+function writeHostPayload(options) {
+    const host = options.host ?? 'copilot';
+    if (host === 'codex')
+        return { host, copilot: null, claudeContract: null, payloadMissing: false };
+    const withCopilot = host === 'copilot' || host === 'both';
+    const withClaude = host === 'claude' || host === 'both';
+    const source = options.sourceGithubDir;
+    if (!source) {
+        return { host, copilot: null, claudeContract: null, payloadMissing: true };
+    }
+    const githubDir = join(options.projectPath, '.github');
+    const copilot = withCopilot
+        ? copyGithubFiles(source, join(githubDir, 'agents'), join(githubDir, 'instructions'), join(githubDir, 'prompts'), join(githubDir, 'skills'), join(githubDir, 'copilot-instructions.md'), options.packageVersion)
+        : null;
+    const claudeContract = withClaude
+        ? writeClaudeContractBlock(options.projectPath, source, options.projectName)
+        : null;
+    return {
+        host,
+        copilot,
+        claudeContract,
+        payloadMissing: claudeContract?.status === 'unavailable',
+    };
+}
+/**
+ * Append the entries a `.gitignore` does not already carry as a line of its own.
+ * Existing rules are never rewritten. Returns the lines that were appended.
+ */
+export function appendGitignoreEntries(gitignorePath, entries) {
+    const existing = existsSync(gitignorePath) ? readFileSync(gitignorePath, 'utf-8') : '';
+    const present = new Set(existing.split(/\r?\n/).map((line) => line.trim()));
+    const missing = entries.filter((entry) => !present.has(entry));
+    if (missing.length === 0)
+        return [];
+    const separator = existing === '' ? '' : existing.endsWith('\n') ? '\n' : '\n\n';
+    writeFileSync(gitignorePath, `${existing}${separator}# DevSteps runtime state\n${missing.join('\n')}\n`);
+    return missing;
+}
+//# sourceMappingURL=init-project.js.map