163 lines
8.5 KiB
Python
163 lines
8.5 KiB
Python
import json
|
|
import pathlib
|
|
import subprocess
|
|
import sys
|
|
import tempfile
|
|
import unittest
|
|
|
|
ROOT = pathlib.Path(__file__).resolve().parents[1]
|
|
SCRIPT = ROOT / 'installer.py'
|
|
|
|
class InstallerTest(unittest.TestCase):
|
|
def setUp(self):
|
|
self.tmp = tempfile.TemporaryDirectory()
|
|
self.addCleanup(self.tmp.cleanup)
|
|
self.home = pathlib.Path(self.tmp.name) / 'home'
|
|
self.home.mkdir()
|
|
(self.home / 'config.yaml').write_text('untouched: true\n')
|
|
(self.home / 'cron').mkdir()
|
|
(self.home / 'cron/jobs.json').write_text('{"jobs":[]}')
|
|
|
|
def run_cli(self, action, *extra):
|
|
return subprocess.run([sys.executable, str(SCRIPT), action,
|
|
'--target-home', str(self.home), *extra],
|
|
capture_output=True, text=True)
|
|
|
|
def test_install_is_idempotent_and_verify_is_read_only(self):
|
|
result = self.run_cli('install')
|
|
self.assertEqual(result.returncode, 0, result.stderr)
|
|
first = {str(p.relative_to(self.home)): (p.read_bytes(), p.stat().st_mtime_ns)
|
|
for p in self.home.rglob('*') if p.is_file()}
|
|
self.assertEqual(self.run_cli('install').returncode, 0)
|
|
self.assertEqual(self.run_cli('verify').returncode, 0)
|
|
second = {str(p.relative_to(self.home)): (p.read_bytes(), p.stat().st_mtime_ns)
|
|
for p in self.home.rglob('*') if p.is_file()}
|
|
self.assertEqual(first, second)
|
|
self.assertEqual((self.home / 'config.yaml').read_text(), 'untouched: true\n')
|
|
self.assertEqual((self.home / 'cron/jobs.json').read_text(), '{"jobs":[]}')
|
|
skills = list((self.home / 'profiles/pmo/skills').rglob('SKILL.md'))
|
|
self.assertTrue(skills)
|
|
status = json.loads((self.home / 'editorial-v4/status.json').read_text())
|
|
self.assertEqual(status['stage'], 'blocked')
|
|
self.assertFalse(status['cron_activation_allowed'])
|
|
|
|
def test_verified_previous_payload_can_upgrade_without_losing_rollback(self):
|
|
import hashlib
|
|
path = self.home / 'profiles/pmo/skills/canina-editorial-v4/SKILL.md'
|
|
path.parent.mkdir(parents=True)
|
|
path.write_text('original owned content')
|
|
path.chmod(0o600)
|
|
self.assertEqual(self.run_cli('install').returncode, 0)
|
|
journal = self.home / 'editorial-v4/.installer/transaction.json'
|
|
state = json.loads(journal.read_text())
|
|
original_before = state['before']
|
|
# CI1285: live payload exactly matches the previous journal, while
|
|
# the incoming reviewed package changes the PMO skill only.
|
|
path.write_text('previous reviewed PMO skill')
|
|
state['installed'][str(path.relative_to(self.home))] = hashlib.sha256(path.read_bytes()).hexdigest()
|
|
journal.write_text(json.dumps(state))
|
|
result = self.run_cli('install')
|
|
self.assertEqual(result.returncode, 0, result.stderr)
|
|
self.assertEqual(self.run_cli('verify').returncode, 0)
|
|
self.assertEqual(json.loads(journal.read_text())['before'], original_before)
|
|
snapshot = {str(p.relative_to(self.home)): (p.read_bytes(), p.stat().st_mtime_ns,
|
|
p.stat().st_uid, p.stat().st_gid, p.stat().st_mode)
|
|
for p in self.home.rglob('*') if p.is_file()}
|
|
self.assertEqual(self.run_cli('install').returncode, 0)
|
|
self.assertEqual(snapshot, {str(p.relative_to(self.home)): (p.read_bytes(), p.stat().st_mtime_ns,
|
|
p.stat().st_uid, p.stat().st_gid, p.stat().st_mode)
|
|
for p in self.home.rglob('*') if p.is_file()})
|
|
self.assertEqual(self.run_cli('rollback').returncode, 0)
|
|
self.assertEqual(path.read_text(), 'original owned content')
|
|
self.assertEqual(path.stat().st_mode & 0o777, 0o600)
|
|
|
|
def test_failed_upgrade_restores_previous_payload_and_exact_journal(self):
|
|
import hashlib
|
|
import importlib.util
|
|
from unittest.mock import patch
|
|
spec = importlib.util.spec_from_file_location('installer', SCRIPT)
|
|
installer = importlib.util.module_from_spec(spec)
|
|
spec.loader.exec_module(installer)
|
|
installer.execute('install', self.home)
|
|
path = self.home / 'profiles/pmo/skills/canina-editorial-v4/SKILL.md'
|
|
path.write_text('previous reviewed version')
|
|
journal = self.home / 'editorial-v4/.installer/transaction.json'
|
|
state = json.loads(journal.read_text())
|
|
state['installed'][str(path.relative_to(self.home))] = hashlib.sha256(path.read_bytes()).hexdigest()
|
|
journal.write_text(json.dumps(state))
|
|
original = journal.read_bytes()
|
|
real_atomic = installer.atomic
|
|
failed = False
|
|
def fail_once(destination, data):
|
|
nonlocal failed
|
|
if destination == path and not failed:
|
|
failed = True
|
|
raise OSError('injected write failure')
|
|
return real_atomic(destination, data)
|
|
with patch.object(installer, 'atomic', side_effect=fail_once):
|
|
with self.assertRaisesRegex(OSError, 'injected write failure'):
|
|
installer.execute('install', self.home)
|
|
self.assertEqual(path.read_text(), 'previous reviewed version')
|
|
self.assertTrue(journal.exists(), 'rollback history must survive a failed upgrade')
|
|
self.assertEqual(journal.read_bytes(), original)
|
|
|
|
def test_upgrade_refuses_drift_partial_and_invalid_journal_without_writes(self):
|
|
self.assertEqual(self.run_cli('install').returncode, 0)
|
|
journal = self.home / 'editorial-v4/.installer/transaction.json'
|
|
original = journal.read_bytes()
|
|
path = self.home / 'profiles/pmo/skills/canina-editorial-v4/SKILL.md'
|
|
payload = path.read_bytes()
|
|
for failure in ('drift', 'missing', 'allowlist', 'rollback_data'):
|
|
with self.subTest(failure=failure):
|
|
path.write_bytes(payload)
|
|
journal.write_bytes(original)
|
|
state = json.loads(original)
|
|
if failure == 'drift':
|
|
path.write_text('external change')
|
|
elif failure == 'missing':
|
|
path.unlink()
|
|
elif failure == 'allowlist':
|
|
path.write_text('previous version')
|
|
state['installed'].pop('editorial-v4/status.json')
|
|
journal.write_text(json.dumps(state))
|
|
else:
|
|
path.write_text('previous version')
|
|
state['before']['editorial-v4/status.json'] = {'data': '!!!!', 'mode': 420}
|
|
journal.write_text(json.dumps(state))
|
|
before = {str(p.relative_to(self.home)): (p.read_bytes(), p.stat().st_mtime_ns)
|
|
for p in self.home.rglob('*') if p.is_file()}
|
|
self.assertNotEqual(self.run_cli('install').returncode, 0)
|
|
self.assertEqual(before, {str(p.relative_to(self.home)): (p.read_bytes(), p.stat().st_mtime_ns)
|
|
for p in self.home.rglob('*') if p.is_file()})
|
|
|
|
def test_rollback_restores_previous_files_and_modes(self):
|
|
path = self.home / 'profiles/pmo/skills/canina-editorial-v4/SKILL.md'
|
|
path.parent.mkdir(parents=True)
|
|
path.write_text('previous owned version')
|
|
path.chmod(0o600)
|
|
self.assertEqual(self.run_cli('install').returncode, 0)
|
|
self.assertEqual(self.run_cli('rollback').returncode, 0)
|
|
self.assertEqual(path.read_text(), 'previous owned version')
|
|
self.assertEqual(path.stat().st_mode & 0o777, 0o600)
|
|
self.assertFalse((self.home / 'editorial-v4/status.json').exists())
|
|
self.assertEqual(self.run_cli('rollback').returncode, 0)
|
|
|
|
def test_refuses_symlink_escape_before_copy(self):
|
|
outside = pathlib.Path(self.tmp.name) / 'outside'
|
|
outside.mkdir()
|
|
(self.home / 'profiles').symlink_to(outside, target_is_directory=True)
|
|
self.assertNotEqual(self.run_cli('install').returncode, 0)
|
|
self.assertEqual(list(outside.iterdir()), [])
|
|
self.assertFalse((self.home / 'editorial-v4/status.json').exists())
|
|
|
|
def test_verify_detects_drift_and_rollback_refuses_external_edits(self):
|
|
self.assertEqual(self.run_cli('install').returncode, 0)
|
|
path = self.home / 'profiles/pmo/skills/canina-editorial-v4/SKILL.md'
|
|
path.write_text('external change')
|
|
self.assertNotEqual(self.run_cli('verify').returncode, 0)
|
|
self.assertNotEqual(self.run_cli('rollback').returncode, 0)
|
|
self.assertEqual(path.read_text(), 'external change')
|
|
|
|
if __name__ == '__main__':
|
|
unittest.main()
|