@rpamis/comet 0.4.0-beta.6 → 0.4.0-beta.7

package/dist/domains/comet-native/native-findings.js

@@ -0,0 +1,238 @@
+import path from 'path';
+import { nativeChangeDir } from './native-change.js';
+import { isInsidePath } from './native-paths.js';
+import { isNativeWorkspaceAdvisoryCode } from './native-workspace.js';
+const FINDING_SUMMARY_CODE_BUDGET = 8;
+const EXACT_METADATA = {
+    'brief-blocking-question': {
+        severity: 'error',
+        requiredAction: 'answer-blocking-question',
+        retry: 'next',
+        repair: 'none',
+    },
+    'transition-incomplete': {
+        severity: 'error',
+        requiredAction: 'recover-transition',
+        retry: 'status',
+        repair: 'doctor',
+    },
+    'trajectory-tail-incomplete': {
+        severity: 'error',
+        requiredAction: 'repair-trajectory-tail',
+        retry: 'status',
+        repair: 'doctor',
+    },
+    'checkpoint-progress-invalid': {
+        severity: 'error',
+        requiredAction: 'manually-isolate-invalid-checkpoint',
+        retry: 'none',
+        repair: 'none',
+    },
+    'checkpoint-progress-incomplete': {
+        severity: 'error',
+        requiredAction: 'recover-progress-checkpoint',
+        retry: 'status',
+        repair: 'doctor',
+    },
+    'checkpoint-manifest-invalid': {
+        severity: 'error',
+        requiredAction: 'record-checkpoint-again',
+        retry: 'status',
+        repair: 'none',
+    },
+    'verification-scope-partial': {
+        severity: 'error',
+        requiredAction: 'confirm-partial-verification-scope',
+        retry: 'next',
+        repair: 'none',
+    },
+    'native-change-conflict': {
+        severity: 'error',
+        requiredAction: 'resolve-native-change-conflict',
+        retry: 'status',
+        repair: 'none',
+    },
+    'native-change-overlap': {
+        severity: 'error',
+        requiredAction: 'inspect-native-change-overlap',
+        retry: 'status',
+        repair: 'none',
+    },
+    'contract-changed-after-approval': {
+        severity: 'error',
+        requiredAction: 're-confirm-contract',
+        retry: 'next',
+        repair: 'none',
+    },
+    'baseline-snapshot-incomplete': {
+        severity: 'error',
+        requiredAction: 'resolve-native-baseline',
+        retry: 'none',
+        repair: 'none',
+    },
+    'baseline-snapshot-missing': {
+        severity: 'error',
+        requiredAction: 'resolve-native-baseline',
+        retry: 'none',
+        repair: 'none',
+    },
+    'workspace-inspection-unavailable': {
+        severity: 'info',
+        requiredAction: 'migrate-workspace-identity',
+        retry: 'status',
+        repair: 'doctor',
+    },
+    'repair-stagnation-warning': {
+        severity: 'warning',
+        requiredAction: 'change-repair-approach',
+        retry: 'next',
+        repair: 'none',
+    },
+    'repair-stagnation-stop': {
+        severity: 'error',
+        requiredAction: 'make-progress-or-explicitly-override-repair',
+        retry: 'none',
+        repair: 'none',
+    },
+    'repair-iteration-limit': {
+        severity: 'error',
+        requiredAction: 'change-implementation-before-starting-a-new-repair-episode',
+        retry: 'next',
+        repair: 'none',
+    },
+    'repair-override-exhausted': {
+        severity: 'error',
+        requiredAction: 'review-repeated-failure-after-override',
+        retry: 'none',
+        repair: 'none',
+    },
+};
+function inferredMetadata(code) {
+    const exact = EXACT_METADATA[code];
+    if (exact)
+        return exact;
+    if (/^(?:run-|trajectory-|checkpoint-(?:missing|mismatch|invalid)|transition-invalid)/u.test(code)) {
+        return {
+            severity: 'error',
+            requiredAction: 'isolate-or-restore-native-runtime-from-a-trusted-copy',
+            retry: 'none',
+            repair: 'none',
+        };
+    }
+    if (code.startsWith('brief-')) {
+        return {
+            severity: 'error',
+            requiredAction: 'complete-brief',
+            retry: 'next',
+            repair: 'none',
+        };
+    }
+    if (code.startsWith('spec-')) {
+        return {
+            severity: 'error',
+            requiredAction: 'resolve-spec-state',
+            retry: 'next',
+            repair: 'none',
+        };
+    }
+    if (code.startsWith('verification-')) {
+        return {
+            severity: 'error',
+            requiredAction: 'complete-verification-evidence',
+            retry: 'next',
+            repair: 'none',
+        };
+    }
+    if (code.startsWith('build-')) {
+        return {
+            severity: 'error',
+            requiredAction: 'record-build-evidence',
+            retry: 'next',
+            repair: 'none',
+        };
+    }
+    if (isNativeWorkspaceAdvisoryCode(code)) {
+        return {
+            severity: code === 'workspace-inspection-unavailable' ? 'info' : 'warning',
+            requiredAction: 'inspect-workspace-advisory',
+            retry: 'status',
+            repair: 'none',
+        };
+    }
+    return {
+        severity: 'error',
+        requiredAction: 'resolve-finding',
+        retry: 'status',
+        repair: 'none',
+    };
+}
+function projectRelativePath(paths, state, finding) {
+    if (!finding.path)
+        return null;
+    let target;
+    if (path.isAbsolute(finding.path)) {
+        target = path.resolve(finding.path);
+    }
+    else if (/^(?:brief-|verification-|spec-source)/u.test(finding.code)) {
+        target = path.resolve(nativeChangeDir(paths, state.name), ...finding.path.split(/[\\/]/u));
+    }
+    else {
+        target = path.resolve(paths.projectRoot, ...finding.path.split(/[\\/]/u));
+    }
+    if (!isInsidePath(paths.projectRoot, target))
+        return null;
+    const relative = path.relative(paths.projectRoot, target).replaceAll('\\', '/');
+    return relative === '' ? '.' : relative;
+}
+function retryCommand(retry, state, code) {
+    if (retry === 'next') {
+        return `comet native next ${state.name} --summary "<summary>"${code === 'contract-changed-after-approval' ? ' --confirmed' : ''}`;
+    }
+    if (retry === 'status')
+        return `comet native status ${state.name} --details`;
+    return null;
+}
+export function structureNativeFindings(options) {
+    return options.findings
+        .map((finding) => {
+        const metadata = inferredMetadata(finding.code);
+        return {
+            code: finding.code,
+            message: finding.message,
+            severity: metadata.severity,
+            path: projectRelativePath(options.paths, options.state, finding),
+            requiredAction: metadata.requiredAction,
+            retryCommand: retryCommand(metadata.retry, options.state, finding.code),
+            repairCommand: metadata.repair === 'doctor'
+                ? `comet native doctor ${options.state.name} --repair${finding.code.startsWith('transition-') ? ' --strategy continue' : ''}`
+                : null,
+            // This is intentionally code-based, not severity-based. Model-actionable
+            // missing data must never be presented as a user decision.
+            requiresUserDecision: finding.code === 'brief-blocking-question' ||
+                finding.code === 'contract-changed-after-approval' ||
+                finding.code === 'verification-scope-partial' ||
+                finding.code === 'repair-iteration-limit' ||
+                finding.code === 'repair-override-exhausted',
+        };
+    })
+        .sort((left, right) => {
+        const severityRank = { error: 0, warning: 1, info: 2 };
+        return (severityRank[left.severity] - severityRank[right.severity] ||
+            left.code.localeCompare(right.code) ||
+            (left.path ?? '').localeCompare(right.path ?? '') ||
+            left.message.localeCompare(right.message));
+    });
+}
+export function summarizeNativeFindings(findings) {
+    const codes = [...new Set(findings.map((finding) => finding.code))];
+    return {
+        total: findings.length,
+        errors: findings.filter((finding) => finding.severity === 'error').length,
+        warnings: findings.filter((finding) => finding.severity === 'warning').length,
+        info: findings.filter((finding) => finding.severity === 'info').length,
+        requiresUserDecision: findings.some((finding) => finding.requiresUserDecision),
+        codes: codes.slice(0, FINDING_SUMMARY_CODE_BUDGET),
+        truncated: codes.length > FINDING_SUMMARY_CODE_BUDGET,
+    };
+}
+//# sourceMappingURL=native-findings.js.map

package/dist/domains/comet-native/native-findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-findings.js","sourceRoot":"","sources":["../../../domains/comet-native/native-findings.ts"],"names":[],"mappings":"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"}

package/dist/domains/comet-native/native-guards.d.ts

@@ -0,0 +1,7 @@
+import type { NativeAdvanceEvidence, NativeArtifactValidation, NativeChangeState, NativeProjectPaths } from './native-types.js';
+export declare function inspectNativeGuard(options: {
+    paths: NativeProjectPaths;
+    state: NativeChangeState;
+    evidence: NativeAdvanceEvidence;
+}): Promise<NativeArtifactValidation>;
+//# sourceMappingURL=native-guards.d.ts.map

package/dist/domains/comet-native/native-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-guards.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-guards.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EAEjB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAqD3B,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,qBAAqB,CAAC;CACjC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA0EpC"}

package/dist/domains/comet-native/native-guards.js

@@ -0,0 +1,126 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import { validateNativeBrief, validateNativeSpecChanges, validateNativeVerification, } from './native-artifacts.js';
+import { nativeChangeDir } from './native-change.js';
+import { isInsidePath } from './native-paths.js';
+import { inspectNativeRunConsistency } from './native-run-consistency.js';
+import { filterNativeContentSnapshotToProjectScope, readNativeBaselineManifest, } from './native-snapshot.js';
+function validation(findings) {
+    return { valid: findings.length === 0, findings };
+}
+async function validateBuildArtifacts(paths, evidence) {
+    const findings = [];
+    if ((evidence.noCodeReason ?? '').trim().length > 0)
+        return findings;
+    if (!evidence.artifacts || evidence.artifacts.length === 0) {
+        return [
+            {
+                code: 'build-evidence-missing',
+                message: 'Build requires an artifact reference or an explicit no-code reason',
+            },
+        ];
+    }
+    for (const artifact of evidence.artifacts) {
+        if (path.isAbsolute(artifact) ||
+            artifact.split(/[\\/]/u).includes('..') ||
+            /^(?:[A-Za-z]:|~|[\\/])/u.test(artifact)) {
+            findings.push({
+                code: 'build-artifact-unsafe',
+                message: `Unsafe build artifact: ${artifact}`,
+            });
+            continue;
+        }
+        const target = path.resolve(paths.projectRoot, ...artifact.split(/[\\/]/u));
+        if (!isInsidePath(paths.projectRoot, target)) {
+            findings.push({
+                code: 'build-artifact-unsafe',
+                message: `Unsafe build artifact: ${artifact}`,
+            });
+            continue;
+        }
+        try {
+            await fs.access(target);
+        }
+        catch {
+            findings.push({
+                code: 'build-artifact-missing',
+                message: `Build artifact does not exist: ${artifact}`,
+                path: artifact,
+            });
+        }
+    }
+    return findings;
+}
+export async function inspectNativeGuard(options) {
+    const findings = [];
+    const changeDir = nativeChangeDir(options.paths, options.state.name);
+    if (options.evidence.summary.trim().length === 0) {
+        findings.push({
+            code: 'transition-summary-missing',
+            message: 'Phase transition requires a summary',
+        });
+    }
+    if (options.evidence.confirmed &&
+        options.state.phase !== 'shape' &&
+        options.state.phase !== 'build') {
+        findings.push({
+            code: 'confirmation-not-shape',
+            message: 'Explicit confirmation is only valid while leaving Shape or Build',
+        });
+    }
+    findings.push(...(await inspectNativeRunConsistency(options.paths, options.state)));
+    if (options.state.phase === 'shape' || options.state.phase === 'build') {
+        const capturedBaseline = await readNativeBaselineManifest(options.paths, options.state.name);
+        if (capturedBaseline === null) {
+            findings.push({
+                code: 'baseline-snapshot-missing',
+                message: 'Native baseline is missing; restore a trusted baseline before advancing',
+            });
+        }
+        else {
+            const baseline = await filterNativeContentSnapshotToProjectScope(options.paths, capturedBaseline);
+            if (!baseline.complete) {
+                findings.push({
+                    code: 'baseline-snapshot-incomplete',
+                    message: `Native baseline is incomplete within the project-owned scope (${baseline.omittedCount} omitted entries); resolve the omissions before advancing`,
+                });
+            }
+        }
+    }
+    if (options.state.phase === 'shape') {
+        const brief = await validateNativeBrief(changeDir, options.state.brief);
+        const specs = await validateNativeSpecChanges(options.paths, options.state);
+        findings.push(...brief.findings, ...specs.findings);
+    }
+    else if (options.state.phase === 'build') {
+        findings.push(...(await validateNativeBrief(changeDir, options.state.brief)).findings, ...(await validateNativeSpecChanges(options.paths, options.state)).findings);
+        findings.push(...(await validateBuildArtifacts(options.paths, options.evidence)));
+    }
+    else if (options.state.phase === 'verify') {
+        const report = options.evidence.verificationReport ?? options.state.verification_report;
+        if (!report) {
+            findings.push({
+                code: 'verification-report-missing',
+                message: 'Verify requires a report path',
+            });
+        }
+        else {
+            findings.push(...(await validateNativeVerification(changeDir, report)).findings);
+        }
+        if (!options.evidence.verificationResult) {
+            findings.push({
+                code: 'verification-result-missing',
+                message: 'Verify requires pass or fail',
+            });
+        }
+        findings.push(...(await validateNativeSpecChanges(options.paths, options.state)).findings);
+    }
+    else {
+        findings.push({
+            code: 'archive-command-required',
+            message: 'Use comet native archive for the Archive phase',
+        });
+    }
+    return validation(findings);
+}
+//# sourceMappingURL=native-guards.js.map

package/dist/domains/comet-native/native-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-guards.js","sourceRoot":"","sources":["../../../domains/comet-native/native-guards.ts"],"names":[],"mappings":"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"}

package/dist/domains/comet-native/native-hash.d.ts

@@ -0,0 +1,3 @@
+export declare function sha256File(file: string): Promise<string>;
+export declare function sha256Text(content: string): string;
+//# sourceMappingURL=native-hash.d.ts.map

package/dist/domains/comet-native/native-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-hash.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-hash.ts"],"names":[],"mappings":"AAGA,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI9D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/domains/comet-native/native-hash.js

@@ -0,0 +1,12 @@
+import { createHash } from 'crypto';
+import { createReadStream } from 'fs';
+export async function sha256File(file) {
+    const hash = createHash('sha256');
+    for await (const chunk of createReadStream(file))
+        hash.update(chunk);
+    return hash.digest('hex');
+}
+export function sha256Text(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+//# sourceMappingURL=native-hash.js.map

package/dist/domains/comet-native/native-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-hash.js","sourceRoot":"","sources":["../../../domains/comet-native/native-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,IAAI,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC;QAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/dist/domains/comet-native/native-hook-guard.d.ts

@@ -0,0 +1,17 @@
+import type { CometHookDecision, CometHookIntent, CometHookRequest } from '../comet-entry/hook-types.js';
+import type { NativeChangeState } from './native-types.js';
+export type NativeHookIntent = CometHookIntent;
+export interface NativeHookRequest extends Omit<CometHookRequest, 'toolName'> {
+    toolName?: string | null;
+}
+export type NativeHookGuardResult = CometHookDecision;
+export interface ActiveNativeHookChange {
+    workflow: 'native';
+    name: string;
+    phase: NativeChangeState['phase'];
+}
+export declare function listActiveNativeHookChanges(projectRoot: string): Promise<ActiveNativeHookChange[]>;
+export declare function parseNativeHookRequest(source: string): NativeHookRequest;
+export declare function readNativeHookRequest(): Promise<NativeHookRequest>;
+export declare function inspectNativeHookGuard(projectRoot: string, request: NativeHookRequest, selectedChangeName?: string): Promise<NativeHookGuardResult>;
+//# sourceMappingURL=native-hook-guard.d.ts.map

package/dist/domains/comet-native/native-hook-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-hook-guard.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-hook-guard.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,mBAAmB,CAAC;AAE/E,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAC/C,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAC3E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAEtD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;CACnC;AAkDD,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAOnC;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAGxE;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAGxE;AAED,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,EAC1B,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CA6FhC"}

package/dist/domains/comet-native/native-hook-guard.js

@@ -0,0 +1,154 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import { parseCometHookRequest, readCometHookRequest } from '../comet-entry/hook-adapter.js';
+import { readNativeChange } from './native-change.js';
+import { readProjectConfig } from './native-config.js';
+import { nativeProjectPaths } from './native-paths.js';
+import { resolveSelectedNativeChange } from './native-selection.js';
+function isWithin(parent, target) {
+    const relative = path.relative(parent, target);
+    return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
+}
+function requestTargetsAreControlOnly(projectRoot, nativeRoot, request) {
+    return (request.targets.length > 0 &&
+        request.targets.every((targetPath) => {
+            const target = path.resolve(projectRoot, targetPath);
+            if (!isWithin(projectRoot, target))
+                return true;
+            const relative = path.relative(projectRoot, target).replaceAll('\\', '/');
+            return relative === '.comet/config.yaml' || isWithin(nativeRoot, target);
+        }));
+}
+async function activeNativeContext(projectRoot) {
+    const config = await readProjectConfig(projectRoot);
+    if (!config || !(config.workflows ?? [config.default_workflow]).includes('native'))
+        return null;
+    const paths = await nativeProjectPaths(projectRoot, config.native.artifact_root);
+    let entries;
+    try {
+        entries = await fs.readdir(paths.changesDir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return { paths, changes: [] };
+        throw error;
+    }
+    const changes = [];
+    for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+        if (!entry.isDirectory() || entry.isSymbolicLink())
+            continue;
+        const state = await readNativeChange(paths, entry.name);
+        if (!state.archived)
+            changes.push(state);
+    }
+    return { paths, changes };
+}
+export async function listActiveNativeHookChanges(projectRoot) {
+    const context = await activeNativeContext(projectRoot);
+    return (context?.changes ?? []).map((change) => ({
+        workflow: 'native',
+        name: change.name,
+        phase: change.phase,
+    }));
+}
+export function parseNativeHookRequest(source) {
+    const { intent, targets } = parseCometHookRequest(source);
+    return { intent, targets };
+}
+export async function readNativeHookRequest() {
+    const { intent, targets } = await readCometHookRequest();
+    return { intent, targets };
+}
+export async function inspectNativeHookGuard(projectRoot, request, selectedChangeName) {
+    const context = await activeNativeContext(projectRoot);
+    if (!context)
+        return { allowed: true, reason: 'Native workflow is not enabled' };
+    if (request.intent === 'non-write') {
+        return { allowed: true, reason: 'Hook event is not a write' };
+    }
+    if (context.changes.length === 0) {
+        return {
+            allowed: true,
+            reason: requestTargetsAreControlOnly(projectRoot, context.paths.nativeRoot, request)
+                ? 'Native control artifact write'
+                : 'No Native changes exist',
+        };
+    }
+    let change;
+    if (selectedChangeName) {
+        change = context.changes.find((candidate) => candidate.name === selectedChangeName);
+        if (!change) {
+            return {
+                allowed: false,
+                reason: `Selected Native change ${selectedChangeName} is missing or archived; resume /comet-native before retrying`,
+                workflow: 'native',
+                change: selectedChangeName,
+            };
+        }
+    }
+    else if (context.changes.length === 1) {
+        change = context.changes[0];
+    }
+    else {
+        const selectedName = await resolveSelectedNativeChange(context.paths);
+        change = context.changes.find((candidate) => candidate.name === selectedName);
+        if (!change) {
+            return {
+                allowed: false,
+                reason: 'Multiple Native changes are active; select the change to resume before writing code',
+                workflow: 'native',
+            };
+        }
+    }
+    if (change.phase === 'build') {
+        return {
+            allowed: true,
+            reason: 'Native change is in Build',
+            workflow: 'native',
+            phase: change.phase,
+            change: change.name,
+        };
+    }
+    if (request.intent === 'unknown' || request.targets.length === 0) {
+        return {
+            allowed: false,
+            reason: `Hook write target could not be determined while Native change ${change.name} is in ${change.phase}; resume /comet-native before retrying`,
+            workflow: 'native',
+            phase: change.phase,
+            change: change.name,
+        };
+    }
+    let controlTarget = false;
+    let externalTarget = false;
+    for (const targetPath of request.targets) {
+        const target = path.resolve(projectRoot, targetPath);
+        if (!isWithin(projectRoot, target)) {
+            externalTarget = true;
+            continue;
+        }
+        const relative = path.relative(projectRoot, target).replaceAll('\\', '/');
+        if (relative === '.comet/config.yaml' || isWithin(context.paths.nativeRoot, target)) {
+            controlTarget = true;
+            continue;
+        }
+        return {
+            allowed: false,
+            reason: `Native change ${change.name} is in ${change.phase}; implementation writes are only allowed in build. Resume /comet-native to continue safely`,
+            workflow: 'native',
+            phase: change.phase,
+            change: change.name,
+        };
+    }
+    return {
+        allowed: true,
+        reason: controlTarget
+            ? 'Native control artifact write'
+            : externalTarget
+                ? 'Write target is outside the guarded project'
+                : 'No guarded write target was provided',
+        workflow: 'native',
+        phase: change.phase,
+        change: change.name,
+    };
+}
+//# sourceMappingURL=native-hook-guard.js.map

package/dist/domains/comet-native/native-hook-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-hook-guard.js","sourceRoot":"","sources":["../../../domains/comet-native/native-hook-guard.ts"],"names":[],"mappings":"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"}