@aperant/framework 0.6.2

package/dist/__tests__/install-pipeline.test.js

@@ -0,0 +1,131 @@
+/**
+ * install-pipeline.test.ts — integration: per-runtime install via the
+ * pipeline writes the right files, the manifest hashes match, and the
+ * backward-compat default (no flags, non-TTY) only writes Claude.
+ *
+ * Avoids spawning the apt-tools CLI subprocess by importing the pipeline
+ * + runtime descriptors directly. The init.mjs flag-parsing path is
+ * exercised separately by smoke runs against a temp dir during dev.
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { runInstall } from '../cli/install/pipeline.mjs';
+import { getRuntime, RUNTIMES } from '../cli/install/runtime-detect.mjs';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// __dirname = packages/framework/src/__tests__
+const CANONICAL_ROOT = resolve(__dirname, '..', '..');
+const VERSION = '0.1.0';
+function sha256(buf) {
+    return createHash('sha256').update(buf).digest('hex');
+}
+function walk(dir) {
+    const out = [];
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const p = join(dir, entry.name);
+        if (entry.isDirectory())
+            out.push(...walk(p));
+        else
+            out.push(p);
+    }
+    return out;
+}
+describe('install pipeline integration', () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), 'apt-install-'));
+    });
+    afterEach(() => {
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    for (const runtime of RUNTIMES) {
+        it(`installs ${runtime.id} with manifest + matching file hashes`, async () => {
+            const mod = await import(`../cli/install/transforms/${runtime.id}.mjs`);
+            const r = runInstall({
+                runtime: runtime.id,
+                transform: mod.transform,
+                canonicalRoot: CANONICAL_ROOT,
+                targetDir: tmp,
+                version: VERSION,
+            });
+            expect(r.skipped).toEqual([]);
+            expect(r.files.length).toBeGreaterThan(0);
+            // Manifest exists at the runtime's install root.
+            const manifestPath = join(tmp, runtime.installRoot, 'apt-file-manifest.json');
+            expect(existsSync(manifestPath)).toBe(true);
+            const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+            expect(manifest.runtime).toBe(runtime.id);
+            expect(manifest.framework_version).toBe(VERSION);
+            expect(Array.isArray(manifest.files)).toBe(true);
+            expect(manifest.files.length).toBe(r.files.length);
+            // Every manifest entry's installedHash matches the actual bytes
+            // on disk. Also assert the file exists.
+            for (const entry of manifest.files) {
+                const abs = join(tmp, runtime.installRoot, entry.path);
+                expect(existsSync(abs), `expected ${abs} to exist`).toBe(true);
+                expect(sha256(readFileSync(abs))).toBe(entry.installedHash);
+            }
+        });
+    }
+    it('writes only the requested runtime root when called for one runtime', async () => {
+        const mod = await import('../cli/install/transforms/cursor.mjs');
+        runInstall({
+            runtime: 'cursor',
+            transform: mod.transform,
+            canonicalRoot: CANONICAL_ROOT,
+            targetDir: tmp,
+            version: VERSION,
+        });
+        // .cursor exists; no other runtime root does.
+        expect(existsSync(join(tmp, '.cursor'))).toBe(true);
+        for (const r of RUNTIMES) {
+            if (r.id === 'cursor')
+                continue;
+            expect(existsSync(join(tmp, r.installRoot))).toBe(false);
+        }
+    });
+    it('substitutes {{APT_VERSION}} into installed file headers', async () => {
+        const mod = await import('../cli/install/transforms/claude.mjs');
+        runInstall({
+            runtime: 'claude',
+            transform: mod.transform,
+            canonicalRoot: CANONICAL_ROOT,
+            targetDir: tmp,
+            version: VERSION,
+        });
+        // Pick any installed SKILL.md and assert no literal {{APT_VERSION}}
+        // remains and the version line is materialized.
+        const sample = join(tmp, '.claude', 'skills', 'apt', 'SKILL.md');
+        const content = readFileSync(sample, 'utf-8');
+        expect(content).not.toContain('{{APT_VERSION}}');
+        expect(content).toContain(`apt-skill-version: ${VERSION}`);
+    });
+    it('--all manifest sums match per-runtime walk file count (excluding manifest itself)', async () => {
+        // Install a few runtimes simultaneously; per-runtime file counts
+        // should match the walked tree minus the single manifest file.
+        const subset = ['claude', 'codex', 'cursor'];
+        for (const id of subset) {
+            const mod = await import(`../cli/install/transforms/${id}.mjs`);
+            runInstall({
+                runtime: id,
+                transform: mod.transform,
+                canonicalRoot: CANONICAL_ROOT,
+                targetDir: tmp,
+                version: VERSION,
+            });
+        }
+        for (const id of subset) {
+            const desc = getRuntime(id);
+            if (!desc)
+                continue;
+            const root = join(tmp, desc.installRoot);
+            const files = walk(root).filter((f) => statSync(f).isFile() && !f.endsWith('apt-file-manifest.json'));
+            const manifest = JSON.parse(readFileSync(join(root, 'apt-file-manifest.json'), 'utf-8'));
+            expect(files.length).toBe(manifest.files.length);
+        }
+    });
+});
+//# sourceMappingURL=install-pipeline.test.js.map

package/dist/__tests__/install-pipeline.test.js.map

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

package/dist/__tests__/integration/helpers/make-fixture-project.d.ts

@@ -0,0 +1,59 @@
+/**
+ * make-fixture-project.ts — C30 fixture builder for integration smoke specs.
+ *
+ * Each integration test creates its own per-test project root under
+ * os.tmpdir() via `mkdtempSync`. Optionally seeds:
+ *   - .aperant/state.json         (minimal — matches version 2 shape)
+ *   - .aperant/config.json        (minimal — matches version 4 shape)
+ *   - .aperant/roadmap/{scope}/milestones.json
+ *   - .aperant/tasks/<id>/{spec.md, implementation_plan.json}
+ *
+ * The goal is zero writes into the real repo `.aperant/`. All specs should
+ * `cleanup()` in an afterEach to delete the tmp dir.
+ */
+export interface SeedTask {
+    id: string;
+    description?: string;
+    scope?: string;
+    milestone_id?: string | null;
+    phase_id?: string | null;
+    spec?: string;
+    plan?: unknown;
+}
+export interface SeedRoadmap {
+    scope?: string;
+    milestones?: Array<{
+        id: string;
+        title?: string;
+        phases?: Array<{
+            id: string;
+            title?: string;
+        }>;
+    }>;
+}
+export interface MakeFixtureOptions {
+    /** Seed .aperant/state.json with minimal valid content (default: true). */
+    withState?: boolean;
+    /** Seed .aperant/config.json (default: true). */
+    withConfig?: boolean;
+    /** Seed .aperant/roadmap/<scope>/milestones.json. */
+    withRoadmap?: SeedRoadmap;
+    /** Seed .aperant/tasks/<id>/spec.md + implementation_plan.json. */
+    withTasks?: SeedTask[];
+    /** Initialize the root as a git repo so commands that rely on git metadata work. */
+    withGitRepo?: boolean;
+    /** Run `apt-tools init` in the fixture. Heavier but matches real-world shape. */
+    runInit?: boolean;
+}
+export interface FixtureProject {
+    root: string;
+    aperantDir: string;
+    tasksDir: string;
+    cleanup: () => void;
+    /** Convenience: path to a seeded task's dir. */
+    taskDir: (id: string) => string;
+    /** Write an arbitrary file under root, creating parent dirs. */
+    writeFile: (relPath: string, content: string) => string;
+}
+export declare function makeFixtureProject(options?: MakeFixtureOptions): FixtureProject;
+//# sourceMappingURL=make-fixture-project.d.ts.map

package/dist/__tests__/integration/helpers/make-fixture-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-fixture-project.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/integration/helpers/make-fixture-project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,WAAW;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAA;CAClG;AAED,MAAM,WAAW,kBAAkB;IAClC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,qDAAqD;IACrD,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,mEAAmE;IACnE,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IACtB,oFAAoF;IACpF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,gDAAgD;IAChD,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;IAC/B,gEAAgE;IAChE,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;CACvD;AA8BD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,kBAAuB,GAAG,cAAc,CAyFnF"}

package/dist/__tests__/integration/helpers/make-fixture-project.js

@@ -0,0 +1,130 @@
+/**
+ * make-fixture-project.ts — C30 fixture builder for integration smoke specs.
+ *
+ * Each integration test creates its own per-test project root under
+ * os.tmpdir() via `mkdtempSync`. Optionally seeds:
+ *   - .aperant/state.json         (minimal — matches version 2 shape)
+ *   - .aperant/config.json        (minimal — matches version 4 shape)
+ *   - .aperant/roadmap/{scope}/milestones.json
+ *   - .aperant/tasks/<id>/{spec.md, implementation_plan.json}
+ *
+ * The goal is zero writes into the real repo `.aperant/`. All specs should
+ * `cleanup()` in an afterEach to delete the tmp dir.
+ */
+import { execSync } from 'node:child_process';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+const MINIMAL_STATE = {
+    version: 2,
+    initialized_at: '2026-01-01T00:00:00.000Z',
+    last_activity: '2026-01-01T00:00:00.000Z',
+    active_tasks: {},
+    completed_tasks: [],
+    decisions: {},
+    has_tests: true,
+};
+const MINIMAL_CONFIG = {
+    version: 4,
+    project_type: 'unknown',
+    share: { visibility: 'solo' },
+    autonomy: { default: 1, allow_yolo: true },
+    qa: {
+        approved_threshold: 7,
+        approved_with_notes_threshold: 5,
+        require_proof_for_ui: false,
+        max_fix_iterations: 3,
+    },
+    risk_map: {
+        critical_paths: ['**/auth/**', '**/*.env*'],
+        elevated_paths: ['**/api/**'],
+        safe_paths: ['**/*.css', '**/*.md', '**/*.test.*'],
+    },
+};
+export function makeFixtureProject(options = {}) {
+    const root = mkdtempSync(join(tmpdir(), 'apt-c30-'));
+    const aperantDir = join(root, '.aperant');
+    const tasksDir = join(aperantDir, 'tasks');
+    const writeFile = (relPath, content) => {
+        const abs = join(root, relPath);
+        mkdirSync(join(abs, '..'), { recursive: true });
+        writeFileSync(abs, content);
+        return abs;
+    };
+    const ensureDir = (p) => mkdirSync(p, { recursive: true });
+    if (options.withGitRepo !== false) {
+        // Default to a git repo — many CLI commands touch git metadata.
+        try {
+            execSync('git init -q', { cwd: root, stdio: 'ignore' });
+            execSync('git config user.email test@example.com', { cwd: root, stdio: 'ignore' });
+            execSync('git config user.name test', { cwd: root, stdio: 'ignore' });
+            execSync('git config commit.gpgsign false', { cwd: root, stdio: 'ignore' });
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    if (options.runInit) {
+        ensureDir(aperantDir);
+        // Let the CLI init seed everything.
+        // 0.6.1 — non-TTY init now requires Class A flags or --yes;
+        // fixtures use --yes (CI escape hatch — accepts solo + claude
+        // defaults silently).
+        execSync(`node ${join(__dirname, '../../../../bin/apt-tools.mjs')} init ${root} --yes`, {
+            stdio: 'ignore',
+            env: { ...process.env, APT_SUPPRESS_GITIGNORE_DRIFT: '1' },
+        });
+    }
+    else {
+        ensureDir(aperantDir);
+        if (options.withState !== false) {
+            writeFileSync(join(aperantDir, 'state.json'), JSON.stringify(MINIMAL_STATE, null, 2));
+        }
+        if (options.withConfig !== false) {
+            writeFileSync(join(aperantDir, 'config.json'), JSON.stringify(MINIMAL_CONFIG, null, 2));
+        }
+        ensureDir(tasksDir);
+        ensureDir(join(aperantDir, 'locks'));
+        ensureDir(join(aperantDir, 'events'));
+        ensureDir(join(aperantDir, 'team-status'));
+    }
+    if (options.withRoadmap) {
+        const scope = options.withRoadmap.scope ?? 'project';
+        const roadmapDir = join(aperantDir, 'roadmap', scope);
+        ensureDir(roadmapDir);
+        const payload = {
+            version: 1,
+            scope,
+            milestones: options.withRoadmap.milestones ?? [],
+        };
+        writeFileSync(join(roadmapDir, 'milestones.json'), JSON.stringify(payload, null, 2));
+    }
+    if (options.withTasks) {
+        for (const t of options.withTasks) {
+            const tDir = join(tasksDir, t.id);
+            ensureDir(tDir);
+            if (t.spec !== undefined) {
+                writeFileSync(join(tDir, 'spec.md'), t.spec);
+            }
+            if (t.plan !== undefined) {
+                writeFileSync(join(tDir, 'implementation_plan.json'), JSON.stringify(t.plan, null, 2));
+            }
+        }
+    }
+    return {
+        root,
+        aperantDir,
+        tasksDir,
+        taskDir: (id) => join(tasksDir, id),
+        writeFile,
+        cleanup: () => {
+            try {
+                rmSync(root, { recursive: true, force: true });
+            }
+            catch {
+                /* best-effort */
+            }
+        },
+    };
+}
+//# sourceMappingURL=make-fixture-project.js.map

package/dist/__tests__/integration/helpers/make-fixture-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-fixture-project.js","sourceRoot":"","sources":["../../../../src/__tests__/integration/helpers/make-fixture-project.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/integration/helpers/run-cli.d.ts

@@ -0,0 +1,40 @@
+/**
+ * run-cli.ts — C30 shared integration harness.
+ *
+ * Every smoke-*.test.ts spec imports `runCli` / `runCliJson` from here.
+ * Spawns `node bin/apt-tools.mjs <args>` via spawnSync and returns a thin
+ * result struct. Each invocation is isolated — callers pass a per-test
+ * project dir created by `makeFixtureProject`.
+ */
+export declare const APT_TOOLS: string;
+export interface RunCliResult {
+    status: number;
+    stdout: string;
+    stderr: string;
+    /** Parse stdout as JSON. Throws with a helpful message on failure. */
+    json: <T = unknown>() => T;
+}
+export interface RunCliOptions {
+    /** Extra env vars merged over process.env. */
+    env?: Record<string, string | undefined>;
+    /** stdin payload. */
+    input?: string;
+    /** Fail the test on non-zero exit (default: false — most error-path tests
+     * expect non-zero and assert on it explicitly). */
+    throwOnError?: boolean;
+    /** Override working directory; defaults to process.cwd(). */
+    cwd?: string;
+    /** Timeout in ms. Defaults to 20_000. */
+    timeout?: number;
+}
+/**
+ * Run apt-tools with the given argv. Returns the struct — does NOT throw on
+ * non-zero unless `throwOnError` is set. This is intentional: error-path tests
+ * assert on non-zero status.
+ */
+export declare function runCli(args: readonly string[], options?: RunCliOptions): RunCliResult;
+/**
+ * Convenience: run, assert status===0, parse JSON.
+ */
+export declare function runCliJson<T = unknown>(args: readonly string[], options?: RunCliOptions): T;
+//# sourceMappingURL=run-cli.d.ts.map

package/dist/__tests__/integration/helpers/run-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-cli.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/integration/helpers/run-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,eAAO,MAAM,SAAS,QAAsD,CAAA;AAE5E,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,sEAAsE;IACtE,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,OAAO,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,aAAa;IAC7B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;uDACmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAsBD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,CAoBzF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,CAAC,CAG/F"}

package/dist/__tests__/integration/helpers/run-cli.js

@@ -0,0 +1,61 @@
+/**
+ * run-cli.ts — C30 shared integration harness.
+ *
+ * Every smoke-*.test.ts spec imports `runCli` / `runCliJson` from here.
+ * Spawns `node bin/apt-tools.mjs <args>` via spawnSync and returns a thin
+ * result struct. Each invocation is isolated — callers pass a per-test
+ * project dir created by `makeFixtureProject`.
+ */
+import { spawnSync } from 'node:child_process';
+import { resolve } from 'node:path';
+export const APT_TOOLS = resolve(__dirname, '../../../../bin/apt-tools.mjs');
+function wrapResult(res) {
+    const stdout = res.stdout ?? '';
+    const stderr = res.stderr ?? '';
+    const status = res.status ?? (res.signal ? 128 : 1);
+    return {
+        status,
+        stdout,
+        stderr,
+        json() {
+            try {
+                return JSON.parse(stdout);
+            }
+            catch (err) {
+                throw new Error(`runCli: stdout was not valid JSON (status=${status}).\nstdout=${stdout}\nstderr=${stderr}\nparseError=${err.message}`);
+            }
+        },
+    };
+}
+/**
+ * Run apt-tools with the given argv. Returns the struct — does NOT throw on
+ * non-zero unless `throwOnError` is set. This is intentional: error-path tests
+ * assert on non-zero status.
+ */
+export function runCli(args, options = {}) {
+    const env = { ...process.env, ...(options.env ?? {}) };
+    // Default: suppress drift warnings in tests.
+    if (env.APT_SUPPRESS_GITIGNORE_DRIFT === undefined) {
+        env.APT_SUPPRESS_GITIGNORE_DRIFT = '1';
+    }
+    const res = spawnSync('node', [APT_TOOLS, ...args], {
+        encoding: 'utf-8',
+        cwd: options.cwd,
+        input: options.input,
+        env,
+        timeout: options.timeout ?? 20_000,
+    });
+    const result = wrapResult(res);
+    if (options.throwOnError && result.status !== 0) {
+        throw new Error(`runCli(${args.join(' ')}) failed with status=${result.status}\nstdout=${result.stdout}\nstderr=${result.stderr}`);
+    }
+    return result;
+}
+/**
+ * Convenience: run, assert status===0, parse JSON.
+ */
+export function runCliJson(args, options = {}) {
+    const r = runCli(args, { ...options, throwOnError: true });
+    return r.json();
+}
+//# sourceMappingURL=run-cli.js.map

package/dist/__tests__/integration/helpers/run-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-cli.js","sourceRoot":"","sources":["../../../../src/__tests__/integration/helpers/run-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAyB,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,+BAA+B,CAAC,CAAA;AAwB5E,SAAS,UAAU,CAAC,GAA6B;IAChD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACnD,OAAO;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,IAAI;YACH,IAAI,CAAC;gBACJ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAM,CAAA;YAC/B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACd,6CAA6C,MAAM,cAAc,MAAM,YAAY,MAAM,gBAAiB,GAAa,CAAC,OAAO,EAAE,CACjI,CAAA;YACF,CAAC;QACF,CAAC;KACD,CAAA;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,IAAuB,EAAE,UAAyB,EAAE;IAC1E,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,EAAuB,CAAA;IAC3E,6CAA6C;IAC7C,IAAI,GAAG,CAAC,4BAA4B,KAAK,SAAS,EAAE,CAAC;QACpD,GAAG,CAAC,4BAA4B,GAAG,GAAG,CAAA;IACvC,CAAC;IACD,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,EAAE;QACnD,QAAQ,EAAE,OAAO;QACjB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG;QACH,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,MAAM;KAClC,CAAC,CAAA;IACF,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACd,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,CACjH,CAAA;IACF,CAAC;IACD,OAAO,MAAM,CAAA;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAc,IAAuB,EAAE,UAAyB,EAAE;IAC3F,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1D,OAAO,CAAC,CAAC,IAAI,EAAK,CAAA;AACnB,CAAC"}

package/dist/__tests__/integration/smoke-author-skill.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * smoke-author-skill.test.ts — C30 integration coverage for the author-skill
+ * command (C4).
+ *
+ * Exercises:
+ *   - happy: author-skill <name> --framework-root <tmpdir> writes SKILL.md
+ *            and a structural test file, returning an ok envelope.
+ *   - error: author-skill invoked with no <name> argument exits non-zero.
+ *   - error: author-skill refuses to overwrite an existing skill dir.
+ *
+ * Uses a per-test tmpdir as the --framework-root so the real framework tree
+ * is never touched.
+ */
+export {};
+//# sourceMappingURL=smoke-author-skill.test.d.ts.map

package/dist/__tests__/integration/smoke-author-skill.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-author-skill.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-author-skill.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/__tests__/integration/smoke-author-skill.test.js

@@ -0,0 +1,86 @@
+/**
+ * smoke-author-skill.test.ts — C30 integration coverage for the author-skill
+ * command (C4).
+ *
+ * Exercises:
+ *   - happy: author-skill <name> --framework-root <tmpdir> writes SKILL.md
+ *            and a structural test file, returning an ok envelope.
+ *   - error: author-skill invoked with no <name> argument exits non-zero.
+ *   - error: author-skill refuses to overwrite an existing skill dir.
+ *
+ * Uses a per-test tmpdir as the --framework-root so the real framework tree
+ * is never touched.
+ */
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { runCli } from './helpers/run-cli';
+describe('author-skill', () => {
+    let fwRoot;
+    beforeEach(() => {
+        fwRoot = mkdtempSync(join(tmpdir(), 'smoke-author-skill-'));
+        mkdirSync(join(fwRoot, 'skills'), { recursive: true });
+        mkdirSync(join(fwRoot, 'src', '__tests__'), { recursive: true });
+    });
+    afterEach(() => {
+        if (fwRoot && existsSync(fwRoot)) {
+            rmSync(fwRoot, { recursive: true, force: true });
+        }
+    });
+    it('author-skill happy: scaffolds SKILL.md + structural test in a fresh framework root', () => {
+        // happy: author-skill <name> writes SKILL.md + test file, returns ok envelope
+        const r = runCli([
+            'author-skill',
+            'demo',
+            '--description',
+            'demo skill',
+            '--framework-root',
+            fwRoot,
+        ]);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.status).toBe('ok');
+        expect(parsed.command).toBe('author-skill');
+        expect(parsed.dry_run).toBe(false);
+        expect(parsed.skill_path).toBe(join(fwRoot, 'skills', 'apt-demo', 'SKILL.md'));
+        expect(parsed.test_path).toBe(join(fwRoot, 'src', '__tests__', 'apt-demo-skill-structure.test.ts'));
+        const skill = readFileSync(parsed.skill_path, 'utf-8');
+        expect(skill).toContain('name: apt:demo');
+        expect(skill).toContain('<objective>');
+        expect(skill).toContain('</objective>');
+        expect(skill).toContain('<process>');
+        const test = readFileSync(parsed.test_path, 'utf-8');
+        expect(test).toContain("describe('apt:demo SKILL.md structure'");
+        expect(test).toContain("'skills/apt-demo/SKILL.md'");
+    });
+    it('author-skill error: fails when name argument is missing', () => {
+        // error: author-skill with no <name> arg exits non-zero with usage
+        const r = runCli(['author-skill']);
+        expect(r.status).not.toBe(0);
+        expect(r.stdout + r.stderr).toMatch(/Usage: apt-tools author-skill/);
+    });
+    it('author-skill error: refuses to overwrite an existing skill dir', () => {
+        // error: second invocation with the same name exits non-zero
+        const first = runCli([
+            'author-skill',
+            'dup',
+            '--description',
+            'first',
+            '--framework-root',
+            fwRoot,
+        ]);
+        expect(first.status).toBe(0);
+        const second = runCli([
+            'author-skill',
+            'dup',
+            '--description',
+            'second',
+            '--framework-root',
+            fwRoot,
+        ]);
+        expect(second.status).not.toBe(0);
+        expect(second.stdout + second.stderr).toMatch(/already exists/);
+    });
+});
+//# sourceMappingURL=smoke-author-skill.test.js.map

package/dist/__tests__/integration/smoke-author-skill.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-author-skill.test.js","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-author-skill.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/integration/smoke-bootstrap.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * smoke-bootstrap.test.ts — C30 integration coverage for the
+ * `bootstrap` command (C47).
+ *
+ * Exercises:
+ *   - happy: bootstrap detect on an empty dir returns status:ok with mode:greenfield
+ *   - happy: bootstrap run scaffolds PROJECT.md and derives .aperant/product-context.json
+ *   - error: bootstrap without a subcommand exits non-zero with a usage message
+ *   - error: bootstrap derive-sidecar on a dir without PROJECT.md exits non-zero
+ */
+export {};
+//# sourceMappingURL=smoke-bootstrap.test.d.ts.map

package/dist/__tests__/integration/smoke-bootstrap.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-bootstrap.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-bootstrap.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}