tack-cli 0.1.0

package/dist/ui/Init.js

@@ -0,0 +1,117 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useState } from "react";
+import { Text, Box, useApp } from "ink";
+import SelectInput from "ink-select-input";
+import TextInput from "ink-text-input";
+import { Logo } from "./Logo.js";
+import { DetectorSweep } from "./DetectorSweep.js";
+import { ensureTackIntegrity, ensureTackDir, ensureContextTemplates, specExists, writeSpec, writeAudit, writeDrift, } from "../lib/files.js";
+import { createAudit, createEmptySpec } from "../lib/signals.js";
+import { log } from "../lib/logger.js";
+export function Init() {
+    const { exit } = useApp();
+    const [phase, setPhase] = useState("logo");
+    const [signals, setSignals] = useState([]);
+    const [spec, setSpec] = useState(createEmptySpec("my-project"));
+    const [systemsToClassify, setSystemsToClassify] = useState([]);
+    const [currentSystemIndex, setCurrentSystemIndex] = useState(0);
+    const [projectName, setProjectName] = useState("");
+    const [forbiddenInput, setForbiddenInput] = useState("");
+    React.useEffect(() => {
+        if (phase === "logo") {
+            setTimeout(() => setPhase("check"), 500);
+        }
+    }, [phase]);
+    React.useEffect(() => {
+        if (phase === "check") {
+            if (specExists()) {
+                const { repaired } = ensureTackIntegrity();
+                if (repaired.length > 0) {
+                    log({ event: "repair", files: repaired });
+                    // eslint-disable-next-line no-console
+                    console.log(`\n✓ Repaired .tack integrity (${repaired.length} file(s)): ${repaired.join(", ")}\n`);
+                }
+                else {
+                    // eslint-disable-next-line no-console
+                    console.log("\n⚠ .tack already initialized. Run 'tack status' instead.\n");
+                }
+                exit();
+                return;
+            }
+            ensureTackDir();
+            ensureContextTemplates();
+            setPhase("sweep");
+        }
+    }, [phase, exit]);
+    function handleSweepComplete(detectedSignals) {
+        setSignals(detectedSignals);
+        const systems = detectedSignals.filter((s) => s.category === "system" || s.category === "scope");
+        const unique = new Map();
+        for (const s of systems) {
+            if (!unique.has(s.id))
+                unique.set(s.id, s);
+        }
+        const toClassify = Array.from(unique.values());
+        if (toClassify.length === 0) {
+            setPhase("project_name");
+        }
+        else {
+            setSystemsToClassify(toClassify);
+            setCurrentSystemIndex(0);
+            setPhase("classify");
+        }
+    }
+    function handleClassify(opt) {
+        const current = systemsToClassify[currentSystemIndex];
+        setSpec((prev) => {
+            const next = { ...prev };
+            if (opt.value === "allowed") {
+                next.allowed_systems = [...prev.allowed_systems, current.id];
+            }
+            else if (opt.value === "forbidden") {
+                next.forbidden_systems = [...prev.forbidden_systems, current.id];
+            }
+            return next;
+        });
+        if (currentSystemIndex + 1 < systemsToClassify.length) {
+            setCurrentSystemIndex((i) => i + 1);
+        }
+        else {
+            setPhase("add_forbidden");
+        }
+    }
+    function handleForbiddenSubmit(value) {
+        if (value.trim()) {
+            const items = value
+                .split(",")
+                .map((s) => s.trim())
+                .filter(Boolean);
+            setSpec((prev) => ({
+                ...prev,
+                forbidden_systems: [...prev.forbidden_systems, ...items],
+            }));
+        }
+        setPhase("project_name");
+    }
+    function handleProjectName(value) {
+        const name = value.trim() || "my-project";
+        const finalSpec = { ...spec, project: name };
+        setSpec(finalSpec);
+        writeSpec(finalSpec);
+        writeAudit(createAudit(signals));
+        writeDrift({ items: [] });
+        log({
+            event: "init",
+            spec_seeded: true,
+            systems_detected: signals.filter((s) => s.category === "system").length,
+        });
+        setPhase("done");
+        setTimeout(() => exit(), 1000);
+    }
+    const classifyOptions = [
+        { label: "Allowed — I want this", value: "allowed" },
+        { label: "Forbidden — I don't want this", value: "forbidden" },
+        { label: "Skip — decide later", value: "skip" },
+    ];
+    return (_jsxs(Box, { flexDirection: "column", children: [(phase === "logo" || phase === "check") && _jsx(Logo, {}), phase === "sweep" && (_jsxs(_Fragment, { children: [_jsx(Logo, {}), _jsx(DetectorSweep, { onComplete: handleSweepComplete })] })), phase === "classify" && systemsToClassify[currentSystemIndex] && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: ["Classify detected system (", currentSystemIndex + 1, "/", systemsToClassify.length, "):"] }), _jsxs(Text, { children: ["  ", _jsx(Text, { color: "cyan", children: systemsToClassify[currentSystemIndex].id }), systemsToClassify[currentSystemIndex].detail && (_jsxs(Text, { dimColor: true, children: [" (", systemsToClassify[currentSystemIndex].detail, ")"] }))] }), _jsxs(Text, { dimColor: true, children: ["  ", "Source: ", systemsToClassify[currentSystemIndex].source] }), _jsxs(Text, { dimColor: true, children: ["  ", "Use \u2191/\u2193 to choose, Enter to confirm."] }), _jsx(Box, { marginTop: 1, children: _jsx(SelectInput, { items: classifyOptions, onSelect: handleClassify }) })] })), phase === "add_forbidden" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Any systems you want to explicitly forbid? (comma-separated, or Enter to skip)" }), _jsx(Text, { dimColor: true, children: "e.g.: multi_tenant, admin_panel, background_jobs" }), _jsxs(Box, { marginTop: 1, children: [_jsxs(Text, { children: [">", " "] }), _jsx(TextInput, { value: forbiddenInput, onChange: setForbiddenInput, onSubmit: handleForbiddenSubmit })] })] })), phase === "project_name" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Project name:" }), _jsxs(Box, { children: [_jsxs(Text, { children: [">", " "] }), _jsx(TextInput, { value: projectName, onChange: setProjectName, onSubmit: handleProjectName, placeholder: "my-project" })] })] })), phase === "done" && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "green", bold: true, children: "\u2713 Initialized /.tack/" }), _jsx(Text, { children: "  spec.yaml \u2014 your architecture contract" }), _jsx(Text, { children: "  _audit.yaml \u2014 detector sweep results" }), _jsx(Text, { children: "  _drift.yaml \u2014 drift tracking (empty)" }), _jsx(Text, { children: "  _logs.ndjson \u2014 event log" }), _jsx(Text, { children: "  context.md/goals.md/assumptions.md/open_questions.md \u2014 context templates" }), _jsxs(Text, { dimColor: true, children: ["\n", "Run \"tack status\" for a scan or \"tack watch\" for live monitoring."] })] }))] }));
+}

package/dist/ui/Logo.d.ts

@@ -0,0 +1 @@
+export declare function Logo(): import("react/jsx-runtime").JSX.Element;

package/dist/ui/Logo.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Text, Box } from "ink";
+const LOGO = `
+ ████████╗ █████╗  ██████╗██╗  ██╗
+ ╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝
+    ██║   ███████║██║     █████╔╝
+    ██║   ██╔══██║██║     ██╔═██╗
+    ██║   ██║  ██║╚██████╗██║  ██╗
+    ╚═╝   ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝
+`;
+export function Logo() {
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { color: "cyan", children: LOGO }), _jsx(Text, { dimColor: true, children: "  Architecture drift guard \u2022 v0.1.0" })] }));
+}

package/dist/ui/SpecSummary.d.ts

@@ -0,0 +1,8 @@
+import type { Spec, SpecDiff, DriftState } from "../lib/signals.js";
+type Props = {
+    spec: Spec;
+    diff: SpecDiff;
+    drift?: DriftState;
+};
+export declare function SpecSummary({ spec, diff, drift }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/ui/SpecSummary.js

@@ -0,0 +1,15 @@
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Text, Box } from "ink";
+export function SpecSummary({ spec, diff, drift }) {
+    const unresolvedCount = drift?.items.filter((i) => i.status === "unresolved").length ?? 0;
+    return (_jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsxs(Text, { bold: true, children: ["tack status \u2014 ", spec.project] }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { bold: true, underline: true, children: "SYSTEMS" }), diff.aligned
+                        .filter((s) => s.category === "system")
+                        .map((s) => (_jsxs(Text, { children: ["  ", _jsx(Text, { color: "green", children: "\u2713" }), " ", s.id, ": ", s.detail ?? "detected", " ", _jsx(Text, { dimColor: true, children: "(allowed)" })] }, `${s.id}-${s.detail}`))), diff.violations
+                        .filter((v) => v.type === "forbidden_system")
+                        .map((v) => (_jsxs(Text, { children: ["  ", _jsx(Text, { color: "red", children: "\u2717" }), " ", v.signal.id, " ", _jsxs(Text, { color: "red", children: ["(FORBIDDEN \u2014 ", v.signal.source, ")"] })] }, `${v.signal.id}-${v.signal.source}`))), diff.undeclared
+                        .filter((s) => s.category === "system")
+                        .map((s) => (_jsxs(Text, { children: ["  ", _jsx(Text, { color: "yellow", children: "?" }), " ", s.id, ": ", s.detail ?? "detected", " ", _jsx(Text, { color: "yellow", children: "(undeclared)" })] }, `${s.id}-${s.source}`))), diff.missing.map((id) => (_jsxs(Text, { children: ["  ", _jsx(Text, { dimColor: true, children: "-" }), " ", id, " ", _jsx(Text, { dimColor: true, children: "(allowed but not detected)" })] }, id)))] }), Object.keys(spec.constraints).length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { bold: true, underline: true, children: "CONSTRAINTS" }), Object.entries(spec.constraints).map(([key, val]) => {
+                        const mismatch = diff.violations.find((v) => v.type === "constraint_mismatch" && v.spec_rule.includes(key));
+                        return (_jsxs(Text, { children: ["  ", mismatch ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: "red", children: "\u2717" }), " ", key, ": expected ", val, ", found ", mismatch.signal.detail] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: "green", children: "\u2713" }), " ", key, ": ", val] }))] }, key));
+                    })] })), diff.risks.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { bold: true, underline: true, children: "RISKS" }), diff.risks.map((r) => (_jsxs(Text, { children: ["  ", _jsx(Text, { color: "yellow", children: "\u26A0" }), " ", r.detail ?? r.id] }, r.id)))] })), unresolvedCount > 0 && (_jsxs(_Fragment, { children: [_jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, underline: true, children: "DRIFT" }) }), _jsxs(Text, { children: ["  ", unresolvedCount, " unresolved item(s) ", _jsx(Text, { dimColor: true, children: "(run tack watch to resolve)" })] })] })), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: ["Complexity: ", diff.aligned.filter((s) => s.category === "system").length, " system(s)"] }) })] }));
+}

package/dist/ui/Status.d.ts

@@ -0,0 +1 @@
+export declare function Status(): import("react/jsx-runtime").JSX.Element;

package/dist/ui/Status.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useState } from "react";
+import { Text, Box, useApp } from "ink";
+import { DetectorSweep } from "./DetectorSweep.js";
+import { SpecSummary } from "./SpecSummary.js";
+import { readSpec } from "../lib/files.js";
+import { computeStatusFromSignals } from "../engine/status.js";
+export function Status() {
+    const { exit } = useApp();
+    const [phase, setPhase] = useState("check");
+    const [error, setError] = useState("");
+    const [summaryData, setSummaryData] = useState(null);
+    React.useEffect(() => {
+        if (phase !== "check")
+            return;
+        const spec = readSpec();
+        if (!spec) {
+            setError("No spec.yaml found. Run 'tack init' first.");
+            setPhase("error");
+            setTimeout(() => exit(), 500);
+            return;
+        }
+        setPhase("sweep");
+    }, [phase, exit]);
+    function handleSweepComplete(signals) {
+        const computed = computeStatusFromSignals(signals);
+        if (!computed) {
+            setError("No spec.yaml found. Run 'tack init' first.");
+            setPhase("error");
+            setTimeout(() => exit(), 500);
+            return;
+        }
+        setSummaryData({ spec: computed.spec, diff: computed.diff, drift: computed.drift });
+        setPhase("summary");
+        setTimeout(() => exit(), 100);
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [phase === "sweep" && _jsx(DetectorSweep, { onComplete: handleSweepComplete }), phase === "summary" && summaryData && _jsx(SpecSummary, { spec: summaryData.spec, diff: summaryData.diff, drift: summaryData.drift }), phase === "error" && _jsxs(Text, { color: "red", children: ["\u2717 ", error] })] }));
+}

package/dist/ui/Watch.d.ts

@@ -0,0 +1 @@
+export declare function Watch(): import("react/jsx-runtime").JSX.Element;

package/dist/ui/Watch.js

@@ -0,0 +1,136 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect, useRef } from "react";
+import { Text, Box, Static, useApp, useInput } from "ink";
+import * as path from "node:path";
+import { Logo } from "./Logo.js";
+import { DriftAlert } from "./DriftAlert.js";
+import { readSpec, readDrift, writeAudit } from "../lib/files.js";
+import { createAudit } from "../lib/signals.js";
+import { runAllDetectors } from "../detectors/index.js";
+import { compareSpec } from "../engine/compareSpec.js";
+import { computeDrift } from "../engine/computeDrift.js";
+import { notify } from "../lib/notify.js";
+import { log } from "../lib/logger.js";
+import chokidar from "chokidar";
+const IGNORE_PATTERNS = [
+    "**/node_modules/**",
+    "**/.git/**",
+    "**/.tack/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/.next/**",
+    "**/.cache/**",
+    "**/.svelte-kit/**",
+    "**/coverage/**",
+    "**/venv/**",
+    "**/.venv/**",
+    "**/env/**",
+    "**/site-packages/**",
+];
+export function Watch() {
+    const { exit } = useApp();
+    const [systemCount, setSystemCount] = useState(0);
+    const [driftCount, setDriftCount] = useState(0);
+    const [lastScan, setLastScan] = useState("never");
+    const [pendingAlerts, setPendingAlerts] = useState([]);
+    const [projectName, setProjectName] = useState("unknown");
+    const [history, setHistory] = useState([]);
+    const watcherRef = useRef(null);
+    const debounceTimer = useRef(null);
+    const historySeq = useRef(0);
+    function pushHistory(level, text) {
+        historySeq.current += 1;
+        setHistory((prev) => {
+            const next = [...prev, { id: historySeq.current, level, text }];
+            return next.slice(-40);
+        });
+    }
+    function runScan(reason = "scan") {
+        const startedAt = Date.now();
+        const spec = readSpec();
+        if (!spec)
+            return;
+        setProjectName(spec.project);
+        const { signals } = runAllDetectors();
+        const audit = createAudit(signals);
+        writeAudit(audit);
+        const diff = compareSpec(signals, spec);
+        const { newItems, state } = computeDrift(diff);
+        const unresolvedCount = state.items.filter((i) => i.status === "unresolved").length;
+        setSystemCount(diff.aligned.filter((s) => s.category === "system").length);
+        setDriftCount(unresolvedCount);
+        setLastScan(new Date().toLocaleTimeString());
+        const scanTs = new Date().toLocaleTimeString();
+        if (unresolvedCount === 0) {
+            pushHistory("good", `[${scanTs}] ${reason}: scan clean (0 drift)`);
+        }
+        else {
+            pushHistory("bad", `[${scanTs}] ${reason}: ${unresolvedCount} unresolved drift item(s)`);
+        }
+        log({
+            event: "scan",
+            systems_detected: signals.filter((s) => s.category === "system").length,
+            drift_items: unresolvedCount,
+            duration_ms: Date.now() - startedAt,
+        });
+        const alertable = newItems.filter((i) => i.type === "forbidden_system_detected" ||
+            i.type === "constraint_mismatch" ||
+            i.type === "risk" ||
+            i.type === "undeclared_system");
+        if (alertable.length > 0) {
+            for (const item of alertable) {
+                notify("⚠ Tack: Drift Detected", `${item.system ?? item.risk}: ${item.signal}`);
+            }
+            setPendingAlerts((prev) => [...prev, ...alertable]);
+        }
+    }
+    useEffect(() => {
+        const spec = readSpec();
+        if (!spec) {
+            // eslint-disable-next-line no-console
+            console.error("No spec.yaml found. Run 'tack init' first.");
+            exit();
+            return;
+        }
+        runScan();
+        const watcher = chokidar.watch(".", {
+            ignored: IGNORE_PATTERNS,
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 200,
+                pollInterval: 50,
+            },
+        });
+        watcher.on("all", (event, filepath) => {
+            if (filepath.includes(`${path.sep}.tack${path.sep}`))
+                return;
+            if (filepath.startsWith(".tack/") || filepath.startsWith(".tack\\"))
+                return;
+            pushHistory("update", "Filesystem change detected. Running scan...");
+            if (debounceTimer.current)
+                clearTimeout(debounceTimer.current);
+            debounceTimer.current = setTimeout(() => {
+                runScan(`change (${event})`);
+            }, 300);
+        });
+        watcherRef.current = watcher;
+        return () => {
+            void watcher.close();
+            if (debounceTimer.current)
+                clearTimeout(debounceTimer.current);
+        };
+    }, [exit]);
+    function handleAlertResolved() {
+        setPendingAlerts((prev) => prev.slice(1));
+        const drift = readDrift();
+        setDriftCount(drift.items.filter((i) => i.status === "unresolved").length);
+    }
+    useInput((input) => {
+        if (input === "q") {
+            void watcherRef.current?.close();
+            exit();
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Logo, {}), _jsxs(Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, justifyContent: "space-between", children: [_jsxs(Text, { children: [_jsx(Text, { bold: true, children: projectName }), "  ", _jsxs(Text, { color: "green", children: [systemCount, " systems"] }), "  ", driftCount > 0 ? _jsxs(Text, { color: "yellow", children: [driftCount, " drift"] }) : _jsx(Text, { color: "green", children: "0 drift" })] }), _jsxs(Text, { dimColor: true, children: ["Last scan: ", lastScan] })] }), pendingAlerts.length > 0 && pendingAlerts[0] && _jsx(DriftAlert, { item: pendingAlerts[0], onResolved: handleAlertResolved }), pendingAlerts.length === 0 && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Watching for changes... (q to quit)" }) })), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Static, { items: history, children: (item) => (_jsx(Text, { color: item.level === "good" ? "green" : item.level === "bad" ? "red" : "blue", children: item.text })) }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "\u2500\u2500\u2500 Run in another terminal \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500" }) }), _jsxs(Box, { flexDirection: "column", paddingLeft: 2, children: [_jsxs(Text, { children: [_jsx(Text, { color: "green", children: "tack status" }), _jsx(Text, { dimColor: true, children: "     Project health snapshot" })] }), _jsxs(Text, { children: [_jsx(Text, { color: "green", children: "tack handoff" }), _jsx(Text, { dimColor: true, children: "    Generate handoff for agents" })] }), _jsxs(Text, { children: [_jsx(Text, { color: "green", children: "tack check-in" }), _jsx(Text, { dimColor: true, children: "   Morning/evening pulse" })] }), _jsxs(Text, { children: [_jsx(Text, { color: "green", children: "tack log" }), _jsx(Text, { dimColor: true, children: "        View or append decisions" })] }), _jsxs(Text, { children: [_jsx(Text, { color: "green", children: "tack help" }), _jsx(Text, { dimColor: true, children: "       All commands and options" })] })] })] }));
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "tack-cli",
+  "version": "0.1.0",
+  "description": "Architecture drift guard. Declare your spec. Tack enforces it.",
+  "type": "module",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "tack": "dist/index.js"
+  },
+  "scripts": {
+    "dev": "npm run build && node dist/index.js watch --plain",
+    "dev:bun": "bun run src/index.tsx",
+    "build": "tsc && node scripts/postbuild.cjs",
+    "build:bun": "bun build src/index.tsx --outdir dist --target node && node scripts/postbuild.cjs",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm pack --dry-run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "chokidar": "^3.6.0",
+    "glob": "^10.3.10",
+    "ink": "^4.4.1",
+    "ink-select-input": "^5.0.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^5.0.1",
+    "js-yaml": "^4.1.0",
+    "minimist": "^1.2.8",
+    "node-notifier": "^10.0.1",
+    "picocolors": "^1.1.1",
+    "react": "^18.2.0",
+    "tasuku": "^2.0.1",
+    "update-notifier": "^7.3.1",
+    "yoga-wasm-web": "~0.3.3"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/js-yaml": "^4.0.9",
+    "@types/minimist": "^1.2.5",
+    "@types/node-notifier": "^8.0.5",
+    "@types/react": "^18.2.0",
+    "@types/update-notifier": "^6.0.8",
+    "react-devtools-core": "^4.28.5",
+    "typescript": "^5.3.3"
+  },
+  "license": "MIT"
+}