open-wiki-spec 0.1.0 → 0.2.0

package/dist/core/retrieval/retrieve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve.d.ts","sourceRoot":"","sources":["../../../src/core/retrieval/retrieve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAqB,MAAM,0BAA0B,CAAC;AACnG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAS/E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAuBD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CA0CjB"}
+{"version":3,"file":"retrieve.d.ts","sourceRoot":"","sources":["../../../src/core/retrieval/retrieve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAqB,MAAM,0BAA0B,CAAC;AACnG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAS/E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;;OAIG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAuBD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAwDjB"}

package/dist/core/retrieval/retrieve.js

@@ -29,11 +29,24 @@ export function retrieve(index, query, options) {
     const thresholds = mergeThresholds(DEFAULT_THRESHOLDS, options?.thresholds);
     const maxCandidates = options?.maxCandidates ?? 10;
     // Step 1: Lexical retrieval
-    const firstPass = lexicalRetrieval(query, index);
-    // Step 2: Graph expansion
+    const lexicalCandidates = lexicalRetrieval(query, index);
+    // Step 1b: Merge semantic candidates (if available) before graph expansion
+    const semanticScores = options?.semanticScores;
+    const firstPass = new Set(lexicalCandidates);
+    if (semanticScores) {
+        for (const id of semanticScores.keys()) {
+            if (index.records.has(id)) {
+                firstPass.add(id);
+            }
+        }
+    }
+    // Step 2: Graph expansion (semantic candidates get graph neighbors too)
     const expanded = graphExpand(firstPass, index);
-    // Step 3: Score all expanded candidates
-    const scored = scoreCandidates(expanded, query, index, weights);
+    // Step 3: Score all expanded candidates (with embedding scores for Signal 10)
+    const embeddingScores = semanticScores
+        ? new Map(semanticScores)
+        : undefined;
+    const scored = scoreCandidates(expanded, query, index, weights, embeddingScores);
     // Trim to max candidates
     const topCandidates = scored.slice(0, maxCandidates);
     // Step 4: Classify

package/dist/core/retrieval/retrieve.js.map

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

package/dist/core/retrieval/scoring.d.ts

@@ -8,7 +8,8 @@ export interface ScoredCandidateInternal extends ScoredCandidate {
     signals: ScoringSignal[];
 }
 /**
- * Score all candidates using the 9-signal additive model (section 9.1).
+ * Score all candidates using the additive signal model (section 9.1 + 9.2).
+ * Optional embeddingScores map provides pre-computed cosine similarities for Signal 10.
  */
-export declare function scoreCandidates(candidateIds: Set<string>, query: RetrievalQuery, index: VaultIndex, weights?: ScoringWeights): ScoredCandidate[];
+export declare function scoreCandidates(candidateIds: Set<string>, query: RetrievalQuery, index: VaultIndex, weights?: ScoringWeights, embeddingScores?: Map<string, number>): ScoredCandidate[];
 //# sourceMappingURL=scoring.d.ts.map

package/dist/core/retrieval/scoring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../src/core/retrieval/scoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIpE;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,cAAgC,GACxC,eAAe,EAAE,CA+KnB"}
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../src/core/retrieval/scoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIpE;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,cAAgC,EACzC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,eAAe,EAAE,CAmNnB"}

package/dist/core/retrieval/scoring.js

@@ -1,9 +1,10 @@
 import { DEFAULT_WEIGHTS } from './constants.js';
 import { findSystemByTerm, isActiveChangeStatus } from './helpers.js';
 /**
- * Score all candidates using the 9-signal additive model (section 9.1).
+ * Score all candidates using the additive signal model (section 9.1 + 9.2).
+ * Optional embeddingScores map provides pre-computed cosine similarities for Signal 10.
  */
-export function scoreCandidates(candidateIds, query, index, weights = DEFAULT_WEIGHTS) {
+export function scoreCandidates(candidateIds, query, index, weights = DEFAULT_WEIGHTS, embeddingScores) {
     const allTerms = [...query.feature_terms, ...query.system_terms, ...query.entity_terms];
     const searchTerms = allTerms.map((t) => t.toLowerCase());
     const summaryLower = query.summary.toLowerCase();
@@ -13,8 +14,9 @@ export function scoreCandidates(candidateIds, query, index, weights = DEFAULT_WE
         if (!record)
             continue;
         const signals = [];
-        // Signal 1: Exact title match
+        // Signal 1: Title match (exact, prefix-stripped, or partial)
         const titleLower = record.title.toLowerCase();
+        const titleWithoutPrefix = titleLower.replace(/^(feature|change|system|decision|source|query):\s*/i, '');
         if (titleLower === summaryLower || searchTerms.some((t) => titleLower === t)) {
             signals.push({
                 signal: 'exact_title',
@@ -22,6 +24,22 @@ export function scoreCandidates(candidateIds, query, index, weights = DEFAULT_WE
                 reason: `exact title match: "${record.title}"`,
             });
         }
+        else if (searchTerms.some((t) => titleWithoutPrefix === t)) {
+            // Search term matches title minus type prefix (+30)
+            signals.push({
+                signal: 'exact_title',
+                points: 30,
+                reason: `prefix-stripped title match: "${record.title}"`,
+            });
+        }
+        else if (searchTerms.some((t) => titleLower.includes(t) || titleWithoutPrefix.includes(t))) {
+            // Title contains any search term (+20)
+            signals.push({
+                signal: 'title_partial',
+                points: weights.title_partial,
+                reason: `partial title match: "${record.title}"`,
+            });
+        }
         // Signal 2: Alias match (at most once)
         for (const alias of record.aliases) {
             const aliasLower = alias.toLowerCase();
@@ -146,6 +164,25 @@ export function scoreCandidates(candidateIds, query, index, weights = DEFAULT_WE
                 reason: `strong full-text hit: ${matchedTerms.join(', ')}`,
             });
         }
+        else if (matchedTerms.length === 1) {
+            signals.push({
+                signal: 'full_text_weak',
+                points: weights.full_text_weak,
+                reason: `weak full-text hit: ${matchedTerms.join(', ')}`,
+            });
+        }
+        // Signal 10: Semantic similarity (embedding-based, section 9.2)
+        if (embeddingScores && weights.semantic_similarity) {
+            const similarity = embeddingScores.get(id);
+            if (similarity !== undefined && similarity > 0.7) {
+                const points = Math.round(similarity * weights.semantic_similarity);
+                signals.push({
+                    signal: 'semantic_similarity',
+                    points,
+                    reason: `semantic match: ${similarity.toFixed(2)}`,
+                });
+            }
+        }
         // Compute total score
         let totalScore = signals.reduce((sum, s) => sum + s.points, 0);
         // Status bias bonus (minor tiebreaker)
@@ -159,6 +196,8 @@ export function scoreCandidates(candidateIds, query, index, weights = DEFAULT_WE
                 title: record.title,
                 score: totalScore,
                 reasons: signals.map((s) => s.reason),
+                status: record.status,
+                path: record.path,
             });
         }
     }

package/dist/core/retrieval/scoring.js.map

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

package/dist/core/schema/base.schema.js

@@ -25,7 +25,7 @@ export const BaseFrontmatterSchema = z.object({
     type: NoteTypeEnum,
     id: z.string()
         .min(1, 'id is required')
-        .regex(/^[a-z0-9-]+$/, 'id must be lowercase alphanumeric with hyphens'),
+        .regex(/^[\p{Ll}\p{Lo}\p{N}-]+$/u, 'id must be lowercase alphanumeric (Unicode) with hyphens'),
     status: NoteStatusEnum,
     tags: z.array(z.string()).default([]),
 }).passthrough();

package/dist/core/schema/base.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.schema.js","sourceRoot":"","sources":["../../../src/core/schema/base.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC;IACjC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO;CAC7D,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,UAAU;IACV,UAAU;IACV,SAAS;IACT,aAAa;IACb,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAEzE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,4BAA4B,CAAC,CAAC;AAEhG;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;SACX,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC;SACxB,KAAK,CAAC,cAAc,EAAE,gDAAgD,CAAC;IAC1E,MAAM,EAAE,cAAc;IACtB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACtC,CAAC,CAAC,WAAW,EAAE,CAAC"}
+{"version":3,"file":"base.schema.js","sourceRoot":"","sources":["../../../src/core/schema/base.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC;IACjC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO;CAC7D,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,UAAU;IACV,UAAU;IACV,SAAS;IACT,aAAa;IACb,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAEzE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,4BAA4B,CAAC,CAAC;AAEhG;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;SACX,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC;SACxB,KAAK,CAAC,0BAA0B,EAAE,0DAA0D,CAAC;IAChG,MAAM,EAAE,cAAc;IACtB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACtC,CAAC,CAAC,WAAW,EAAE,CAAC"}

package/dist/core/schema/requirement.d.ts

@@ -47,8 +47,8 @@ export declare const RequirementSchema: z.ZodObject<{
     /** SHA-256 of normalized content */
     content_hash: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    content_hash: string;
     key: string;
+    content_hash: string;
     name: string;
     normative: string;
     scenarios: {
@@ -56,8 +56,8 @@ export declare const RequirementSchema: z.ZodObject<{
         raw_text: string;
     }[];
 }, {
-    content_hash: string;
     key: string;
+    content_hash: string;
     name: string;
     normative: string;
     scenarios: {

package/dist/core/workflow/apply/apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/apply/apply.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EAOT,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,gCAAgC,CAAC;AAkB9E;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,GACd,WAAW,CAoOb;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,GACd,aAAa,CAwCf"}
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/apply/apply.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EAOT,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,gCAAgC,CAAC;AAwE9E;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,GACd,WAAW,CAuZb;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,GACd,aAAa,CA0Cf"}

package/dist/core/workflow/apply/apply.js

@@ -2,8 +2,65 @@ import { join, basename, resolve } from 'node:path';
 import { parseDeltaSummary, validateDeltaConflicts } from './delta-parser.js';
 import { detectStale, computeRequirementHash } from './stale-checker.js';
 import { applyDeltaToFeature } from './feature-updater.js';
+import { assertInsideVault } from '../../../utils/path-safety.js';
 const PROGRAMMATIC_OPS = new Set(['RENAMED', 'REMOVED']);
 const AGENT_DRIVEN_OPS = new Set(['MODIFIED', 'ADDED']);
+const LOCK_FILENAME = '.ows-lock';
+const LOCK_STALE_MS = 5 * 60 * 1000; // 5 minutes
+function acquireLock(vaultRoot, deps) {
+    const lockPath = join(vaultRoot, 'wiki', LOCK_FILENAME);
+    if (deps.fileExists(lockPath)) {
+        // Check if lock is stale (PID dead or timestamp > 5 minutes old)
+        try {
+            const content = deps.readFile(lockPath);
+            const parsed = JSON.parse(content);
+            const lockTime = parsed.timestamp ? new Date(parsed.timestamp).getTime() : 0;
+            const isStaleByTime = Date.now() - lockTime > LOCK_STALE_MS;
+            let isStaleByPid = false;
+            if (parsed.pid) {
+                try {
+                    // process.kill(pid, 0) throws if process doesn't exist
+                    process.kill(parsed.pid, 0);
+                }
+                catch {
+                    isStaleByPid = true;
+                }
+            }
+            if (isStaleByTime || isStaleByPid) {
+                // Force-remove stale lock and retry
+                if (deps.deleteFile) {
+                    deps.deleteFile(lockPath);
+                }
+            }
+            else {
+                return false;
+            }
+        }
+        catch {
+            // If we can't parse the lock, treat as stale and recover
+            if (deps.deleteFile) {
+                try {
+                    deps.deleteFile(lockPath);
+                }
+                catch { /* swallow */ }
+            }
+        }
+    }
+    const lockContent = JSON.stringify({ pid: process.pid, timestamp: new Date().toISOString() });
+    deps.writeFile(lockPath, lockContent);
+    return true;
+}
+function releaseLock(vaultRoot, deps) {
+    const lockPath = join(vaultRoot, 'wiki', LOCK_FILENAME);
+    try {
+        if (deps.deleteFile) {
+            deps.deleteFile(lockPath);
+        }
+    }
+    catch {
+        // Best-effort release — swallow errors
+    }
+}
 function getAtomicPriority(op) {
     switch (op) {
         case 'RENAMED': return 1;
@@ -134,13 +191,16 @@ export function applyChange(options, index, deps) {
         }
         if (errors.length > 0)
             continue;
-        // Apply programmatic operations (RENAMED, REMOVED)
+        // Apply all requirement operations (programmatic + agent-driven markers)
         const mechEntries = reqEntries.filter((e) => PROGRAMMATIC_OPS.has(e.op));
         const agentEntries = reqEntries.filter((e) => AGENT_DRIVEN_OPS.has(e.op));
+        const allReqEntries = [...mechEntries, ...agentEntries];
         const resolvedNotePath = resolve(options.vaultRoot, noteRecord.path);
-        const result = applyDeltaToFeature(noteKey, resolvedNotePath, reqMap, mechEntries);
+        // Read Feature file content for programmatic editing
+        const featureContent = deps.readFile(resolvedNotePath);
+        const result = applyDeltaToFeature(noteKey, resolvedNotePath, reqMap, allReqEntries, featureContent, options.changeId);
         featureResults.push(result);
-        // Collect agent-driven ops
+        // Collect agent-driven ops (MODIFIED/ADDED need agent to fill content)
         for (const entry of agentEntries) {
             pendingAgentOps.push({
                 entry,
@@ -171,7 +231,7 @@ export function applyChange(options, index, deps) {
             preEditSnapshots.set(op.featureId, hashMap);
         }
     }
-    // Handle section operations
+    // Handle section operations — currently unsupported; hard-fail
     const sectionResults = [];
     for (const [noteKey, entries] of deltaPlan.byTargetNote) {
         const secEntries = entries.filter((e) => e.targetType === 'section');
@@ -184,28 +244,201 @@ export function applyChange(options, index, deps) {
                 notePath: resolve(options.vaultRoot, secNoteRecord.path),
                 sectionName: entry.targetName,
                 op: entry.op,
-                success: true, // Section ops are agent-driven
+                success: false,
+                error: 'Section-level operations are not yet supported. Use requirement-level operations.',
             });
         }
     }
+    // Block apply if ANY section-level operations exist
+    if (sectionResults.length > 0) {
+        errors.push('Cannot apply: contains section-level operations which are not yet supported');
+        return {
+            changeId: options.changeId,
+            changeName: changeRecord.title,
+            success: false,
+            staleReport,
+            featureResults,
+            sectionResults,
+            postValidation: allPostValidations,
+            pendingAgentOps,
+            preEditSnapshots,
+            statusTransitioned: false,
+            modifiedFiles: [],
+            warnings,
+            errors,
+        };
+    }
     // === PHASE 2: Write (only if Phase 1 passed) ===
+    // Uses atomic temp-file pattern: write to .ows-tmp first, then rename all at once.
     let statusTransitioned = false;
+    const modifiedFiles = [];
+    // When noAutoTransition is set and there are pending agent ops, skip auto-transition.
+    // The agent must fill markers first, then run apply again (or verifyApply).
+    const skipTransition = options.noAutoTransition && pendingAgentOps.length > 0;
     if (!options.dryRun) {
-        // Write programmatic changes (RENAMED, REMOVED only)
-        // Feature content rebuilding from reqMap would be needed here
-        // For now, the agent handles the actual file writes
-        // If no agent-driven ops, transition to applied
-        if (pendingAgentOps.length === 0) {
-            const content = deps.readFile(resolvedChangePath);
-            const updated = content.replace(/^(status:\s*).+$/m, '$1applied');
-            deps.writeFile(resolvedChangePath, updated);
-            statusTransitioned = true;
+        // Acquire vault-level lock
+        if (!acquireLock(options.vaultRoot, deps)) {
+            errors.push('Cannot apply: another apply operation is in progress (wiki/.ows-lock exists)');
+            return {
+                changeId: options.changeId,
+                changeName: changeRecord.title,
+                success: false,
+                staleReport,
+                featureResults,
+                sectionResults,
+                postValidation: allPostValidations,
+                pendingAgentOps,
+                preEditSnapshots,
+                statusTransitioned: false,
+                modifiedFiles: [],
+                warnings,
+                errors,
+            };
+        }
+        try {
+            // Collect all pending writes as {path, content} pairs
+            const pendingWrites = [];
+            for (const featureResult of featureResults) {
+                if (featureResult.requiresWrite && featureResult.updatedContent) {
+                    pendingWrites.push({ path: featureResult.featurePath, content: featureResult.updatedContent });
+                }
+            }
+            // Status transition content — skip if noAutoTransition with pending ops
+            const changeContent = deps.readFile(resolvedChangePath);
+            const updatedChangeContent = skipTransition
+                ? changeContent // keep current status (in_progress)
+                : changeContent.replace(/^(status:\s*).+$/m, '$1applied');
+            pendingWrites.push({ path: resolvedChangePath, content: updatedChangeContent });
+            // Use unique temp suffix to avoid collisions
+            const tmpSuffix = `.ows-tmp-${Date.now()}`;
+            // Phase 2a: Write all to temp files
+            const tmpPaths = [];
+            let writeFailed = false;
+            for (const { path, content } of pendingWrites) {
+                assertInsideVault(path, options.vaultRoot);
+                const tmpPath = `${path}${tmpSuffix}`;
+                try {
+                    deps.writeFile(tmpPath, content);
+                    tmpPaths.push(tmpPath);
+                }
+                catch (err) {
+                    errors.push(`Failed to write temp file ${tmpPath}: ${err.message}`);
+                    writeFailed = true;
+                    break;
+                }
+            }
+            if (writeFailed) {
+                // Cleanup: remove any temp files already written
+                cleanupTempFiles(tmpPaths, deps);
+            }
+            else {
+                // Phase 2b: Backup originals, then rename temp files to final paths (atomic swap)
+                const backupSuffix = `.ows-backup-${Date.now()}`;
+                const backedUpPaths = [];
+                let backupFailed = false;
+                // Backup existing originals before overwriting
+                for (const { path } of pendingWrites) {
+                    if (deps.fileExists(path)) {
+                        const backupPath = `${path}${backupSuffix}`;
+                        try {
+                            deps.moveFile(path, backupPath);
+                            backedUpPaths.push({ original: path, backup: backupPath });
+                        }
+                        catch (err) {
+                            errors.push(`Failed to backup ${path}: ${err.message}`);
+                            backupFailed = true;
+                            break;
+                        }
+                    }
+                }
+                if (backupFailed) {
+                    // Restore any backups already made
+                    for (const { original, backup } of backedUpPaths) {
+                        try {
+                            deps.moveFile(backup, original);
+                        }
+                        catch {
+                            // Best-effort restore — swallow errors
+                        }
+                    }
+                    // Cleanup temp files
+                    const allTmps = pendingWrites.map((w) => `${w.path}${tmpSuffix}`);
+                    cleanupTempFiles(allTmps, deps);
+                }
+                else {
+                    // Now rename temp files to final paths
+                    let renameFailed = false;
+                    const renamedPaths = [];
+                    for (let i = 0; i < pendingWrites.length; i++) {
+                        const { path } = pendingWrites[i];
+                        const tmpPath = `${path}${tmpSuffix}`;
+                        try {
+                            deps.moveFile(tmpPath, path);
+                            renamedPaths.push(path);
+                        }
+                        catch (err) {
+                            errors.push(`Failed to rename ${tmpPath} -> ${path}: ${err.message}`);
+                            renameFailed = true;
+                            break;
+                        }
+                    }
+                    if (renameFailed) {
+                        // Remove successfully renamed temp->final files and restore from backup
+                        for (const renamedPath of renamedPaths) {
+                            try {
+                                if (deps.deleteFile) {
+                                    deps.deleteFile(renamedPath);
+                                }
+                            }
+                            catch {
+                                // Best-effort — swallow errors
+                            }
+                        }
+                        // Restore all backups
+                        for (const { original, backup } of backedUpPaths) {
+                            try {
+                                deps.moveFile(backup, original);
+                            }
+                            catch {
+                                // Best-effort restore — swallow errors
+                            }
+                        }
+                        // Cleanup remaining temp files (the ones not yet renamed)
+                        const remainingTmps = pendingWrites
+                            .filter((w) => !renamedPaths.includes(w.path))
+                            .map((w) => `${w.path}${tmpSuffix}`);
+                        cleanupTempFiles(remainingTmps, deps);
+                    }
+                    else {
+                        // All writes succeeded — delete backups
+                        for (const { backup } of backedUpPaths) {
+                            try {
+                                if (deps.deleteFile) {
+                                    deps.deleteFile(backup);
+                                }
+                            }
+                            catch {
+                                // Best-effort cleanup — swallow errors
+                            }
+                        }
+                        for (const { path } of pendingWrites) {
+                            if (path !== resolvedChangePath) {
+                                modifiedFiles.push(path);
+                            }
+                        }
+                        statusTransitioned = !skipTransition;
+                    }
+                }
+            }
+        }
+        finally {
+            releaseLock(options.vaultRoot, deps);
         }
     }
     return {
         changeId: options.changeId,
         changeName: changeRecord.title,
-        success: true,
+        success: errors.length === 0,
         staleReport,
         featureResults,
         sectionResults,
@@ -213,6 +446,7 @@ export function applyChange(options, index, deps) {
         pendingAgentOps,
         preEditSnapshots,
         statusTransitioned,
+        modifiedFiles,
         warnings,
         errors,
     };
@@ -235,9 +469,11 @@ export function archiveChange(options, index, deps) {
         };
     }
     const resolvedFromPath = resolve(options.vaultRoot, changeRecord.path);
+    assertInsideVault(resolvedFromPath, options.vaultRoot);
     const filename = basename(changeRecord.path);
     const archiveDir = join(options.vaultRoot, 'wiki', '99-archive');
     const toPath = join(archiveDir, filename);
+    assertInsideVault(toPath, options.vaultRoot);
     if (deps.fileExists(toPath)) {
         return {
             success: false,
@@ -282,6 +518,19 @@ function preValidateEntry(entry, requirements) {
         }
     }
 }
+/** Best-effort cleanup of temp files. Errors are swallowed. */
+function cleanupTempFiles(tmpPaths, deps) {
+    for (const tmpPath of tmpPaths) {
+        try {
+            if (deps.deleteFile) {
+                deps.deleteFile(tmpPath);
+            }
+        }
+        catch {
+            // Best-effort cleanup — swallow errors
+        }
+    }
+}
 function makeResult(options, changeRecord, overrides) {
     return {
         changeId: options.changeId,
@@ -294,6 +543,7 @@ function makeResult(options, changeRecord, overrides) {
         pendingAgentOps: [],
         preEditSnapshots: new Map(),
         statusTransitioned: false,
+        modifiedFiles: [],
         warnings: [],
         errors: [],
         ...overrides,