intent-record 1.0.0

data/lib/intent_record/web/routes/sources.rb

@@ -0,0 +1,19 @@
+require_relative "../../commands/by_source"
+
+module IntentRecord
+  module Web
+    module Routes
+      module Sources
+        EMPTY = { "intents" => [], "asset_versions" => [], "sources" => [] }.freeze
+
+        def self.registered(app)
+          app.get "/sources" do
+            uri = params[:uri].to_s
+            result = uri.strip.empty? ? EMPTY : Commands::BySource.new(uri: uri, contains: true).call
+            erb :sources, locals: { uri: uri, intents: result["intents"], versions: result["asset_versions"] }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/intent_record/web/views/_intent_cards.erb

@@ -0,0 +1,43 @@
+<% if records.empty? %>
+  <p class="empty">No intent records found.</p>
+<% end %>
+<% records.each do |r| %>
+  <article class="card intent">
+    <header>
+      <h2><a href="/intents/<%= h r["intent_id"] %>"><%= h r["summary"] %></a></h2>
+      <div class="meta">
+        <% if r["author"] %><span class="author"><%= h r["author"] %></span> · <% end %>
+        <span class="timestamp"><%= h r["created_at"] %></span>
+        · <code class="id"><%= h r["intent_id"] %></code>
+      </div>
+    </header>
+    <div class="body"><%= h r["body"] %></div>
+    <% if r["asset_versions"].any? %>
+      <div class="links">
+        <span class="label">Commits</span>
+        <% r["asset_versions"].each do |v| %>
+          <a class="chip" href="/commits/<%= h v["external_id"] %>?vcs=<%= h v["vcs"] %>"><%= h v["vcs"] %> <code><%= h v["external_id"][0, 12] %></code></a>
+        <% end %>
+      </div>
+    <% end %>
+    <% if r["stakeholder_references"].any? %>
+      <div class="links">
+        <span class="label">Stakeholders</span>
+        <% r["stakeholder_references"].each do |s| %>
+          <a class="chip ext" href="<%= h s["uri"] %>" target="_blank" rel="noopener"><%= h s["system"] %>: <%= h(s["title"] || s["uri"]) %></a>
+        <% end %>
+      </div>
+    <% end %>
+    <% if r["related_intents"].any? || r["related_by_intents"].any? %>
+      <div class="links">
+        <span class="label">Related</span>
+        <% r["related_intents"].each do |x| %>
+          <a class="chip" href="/intents/<%= h x["intent_id"] %>">builds on: <%= h x["summary"] %></a>
+        <% end %>
+        <% r["related_by_intents"].each do |x| %>
+          <a class="chip" href="/intents/<%= h x["intent_id"] %>">followed by: <%= h x["summary"] %></a>
+        <% end %>
+      </div>
+    <% end %>
+  </article>
+<% end %>

data/lib/intent_record/web/views/commit.erb

@@ -0,0 +1,12 @@
+<header>
+  <h1><%= h version["vcs"] %> <code><%= h version["external_id"] %></code></h1>
+  <% if intents.size > 1 %>
+    <p class="subtitle"><%= intents.size %> intent records for this asset version, recorded in this order. Later records usually refine earlier ones.</p>
+  <% else %>
+    <p class="subtitle"><%= intents.size %> intent record for this asset version</p>
+  <% end %>
+</header>
+<% intents.each_with_index do |intent, i| %>
+  <% if intents.size > 1 %><h3><%= i + 1 %> of <%= intents.size %></h3><% end %>
+  <%= intent_cards([intent]) %>
+<% end %>

data/lib/intent_record/web/views/error.erb

@@ -0,0 +1,7 @@
+<header>
+  <h1><%= h title %></h1>
+  <p class="subtitle"><%= h message %></p>
+</header>
+<section class="card muted">
+  <p>No intent records could be shown. Try a longer commit prefix, a ticket URL, or a few words from the change.</p>
+</section>

data/lib/intent_record/web/views/home.erb

@@ -0,0 +1,14 @@
+<header>
+  <h1>What was this change for?</h1>
+  <p class="subtitle">Paste a commit hash above to read the intent recorded against it. Ticket URLs and free text work too.</p>
+</header>
+<% if recent.empty? %>
+  <section class="card muted">
+    <h2>Nothing recorded yet</h2>
+    <p>Agents record intent from the CLI:</p>
+    <pre>echo '{"summary": "Add retry to fetcher", "body": "Why: ...", "commits": ["&lt;git hash&gt;"]}' | intent-record record</pre>
+  </section>
+<% else %>
+  <h3>Recent intents</h3>
+  <%= intent_cards(recent) %>
+<% end %>

data/lib/intent_record/web/views/intent.erb

@@ -0,0 +1,5 @@
+<header>
+  <h1><%= h intent["summary"] %></h1>
+  <p class="subtitle">Intent record <code><%= h intent["intent_id"] %></code></p>
+</header>
+<%= intent_cards([intent]) %>

data/lib/intent_record/web/views/layout.erb

@@ -0,0 +1,28 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>intent-record</title>
+  <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 16 16%22><circle cx=%228%22 cy=%228%22 r=%227%22 fill=%22%239BC4E2%22/></svg>">
+  <link rel="stylesheet" href="/styles.css">
+</head>
+<body>
+  <header class="topnav">
+    <a class="brand" href="/">intent-record</a>
+    <form class="lookup" method="get" action="/go">
+      <input type="text" name="q" placeholder="Commit hash, ticket URL, or words" value="<%= h(params[:q] || params[:uri] || "") %>" autofocus>
+      <button type="submit">Look up</button>
+    </form>
+    <div class="who">localhost</div>
+  </header>
+  <main class="page">
+    <%= yield %>
+  </main>
+  <footer class="footer">
+    Records are written by agents and people from the command line:
+    <code>echo '{"summary": "...", "body": "...", "commits": ["&lt;hash&gt;"]}' | intent-record record</code>
+    · run <code>intent-record --help</code> for the rest.
+  </footer>
+</body>
+</html>

data/lib/intent_record/web/views/search.erb

@@ -0,0 +1,5 @@
+<header>
+  <h1>Search: <%= h query %></h1>
+  <p class="subtitle">Intents whose summary, body, or linked ticket URL or title contain every word</p>
+</header>
+<%= intent_cards(intents) %>

data/lib/intent_record/web/views/sources.erb

@@ -0,0 +1,16 @@
+<header>
+  <h1>Stakeholder source: <%= h uri %></h1>
+  <p class="subtitle">What was built for this, and why. Matches any source whose URI contains this text.</p>
+</header>
+<% if versions.any? %>
+  <section class="card tint">
+    <h2>Commits</h2>
+    <ul class="commit-list">
+      <% versions.each do |v| %>
+        <li><span class="chip"><%= h v["vcs"] %></span> <a href="/commits/<%= h v["external_id"] %>?vcs=<%= h v["vcs"] %>" class="commit-list-item"><%= h v["external_id"] %></a></li>
+      <% end %>
+    </ul>
+  </section>
+<% end %>
+<h3>Intents</h3>
+<%= intent_cards(intents) %>

data/lib/intent_record.rb

@@ -0,0 +1,28 @@
+require "active_record"
+require "active_support"
+require "json"
+require "time"
+
+require "intent_record/version"
+
+module IntentRecord
+  class Error < StandardError; end
+  class ValidationError < Error; end
+  class NotFoundError < Error; end
+  class ConfigError < Error; end
+  class DatabaseError < Error; end
+end
+
+require "intent_record/config"
+require "intent_record/database"
+require "intent_record/global_id"
+require "intent_record/application_record"
+require "intent_record/models/vcs_system"
+require "intent_record/models/asset_version"
+require "intent_record/models/intent_record"
+require "intent_record/models/intent_record_asset_version"
+require "intent_record/models/stakeholder_system"
+require "intent_record/models/stakeholder_source"
+require "intent_record/models/stakeholder_reference"
+require "intent_record/models/intent_record_link"
+require "intent_record/cli"

metadata

@@ -0,0 +1,194 @@
+--- !ruby/object:Gem::Specification
+name: intent-record
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Erik T. Madsen
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.4'
+- !ruby/object:Gem::Dependency
+  name: rackup
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: A local, agent-first store that links the written intent behind a code
+  change to its VCS commit and to stakeholder systems such as Jira, Confluence and
+  Linear. JSON in, JSON out on the CLI, plus a small read-oriented web GUI. A Claude
+  Code skill that drives it is at https://github.com/beatmadsen/claude-skills/tree/main/skills/intent-record.
+email: []
+executables:
+- intent-record
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- db/migrate/20260918000001_create_initial_schema.rb
+- exe/intent-record
+- lib/intent_record.rb
+- lib/intent_record/application_record.rb
+- lib/intent_record/asset_version_normalizer.rb
+- lib/intent_record/asset_version_resolver.rb
+- lib/intent_record/cli.rb
+- lib/intent_record/cli/argv_parser.rb
+- lib/intent_record/cli/dispatch.rb
+- lib/intent_record/cli/stdin_json.rb
+- lib/intent_record/cli/streams.rb
+- lib/intent_record/cli/usage.rb
+- lib/intent_record/commands/attach.rb
+- lib/intent_record/commands/by_source.rb
+- lib/intent_record/commands/lookup.rb
+- lib/intent_record/commands/recent.rb
+- lib/intent_record/commands/record.rb
+- lib/intent_record/commands/search.rb
+- lib/intent_record/commands/show.rb
+- lib/intent_record/commands/systems.rb
+- lib/intent_record/config.rb
+- lib/intent_record/database.rb
+- lib/intent_record/formatter.rb
+- lib/intent_record/global_id.rb
+- lib/intent_record/input_validator.rb
+- lib/intent_record/like_pattern.rb
+- lib/intent_record/linkers/asset_version_linker.rb
+- lib/intent_record/linkers/asset_version_specs.rb
+- lib/intent_record/linkers/intent_linker.rb
+- lib/intent_record/linkers/stakeholder_linker.rb
+- lib/intent_record/models/asset_version.rb
+- lib/intent_record/models/intent_record.rb
+- lib/intent_record/models/intent_record_asset_version.rb
+- lib/intent_record/models/intent_record_link.rb
+- lib/intent_record/models/stakeholder_reference.rb
+- lib/intent_record/models/stakeholder_source.rb
+- lib/intent_record/models/stakeholder_system.rb
+- lib/intent_record/models/vcs_system.rb
+- lib/intent_record/seeds.rb
+- lib/intent_record/sqlite_connection_setup.rb
+- lib/intent_record/stakeholder_normalizer.rb
+- lib/intent_record/version.rb
+- lib/intent_record/web/app.rb
+- lib/intent_record/web/boot.rb
+- lib/intent_record/web/public/styles.css
+- lib/intent_record/web/query_router.rb
+- lib/intent_record/web/routes/commits.rb
+- lib/intent_record/web/routes/home.rb
+- lib/intent_record/web/routes/intents.rb
+- lib/intent_record/web/routes/search.rb
+- lib/intent_record/web/routes/sources.rb
+- lib/intent_record/web/views/_intent_cards.erb
+- lib/intent_record/web/views/commit.erb
+- lib/intent_record/web/views/error.erb
+- lib/intent_record/web/views/home.erb
+- lib/intent_record/web/views/intent.erb
+- lib/intent_record/web/views/layout.erb
+- lib/intent_record/web/views/search.erb
+- lib/intent_record/web/views/sources.erb
+homepage: https://github.com/beatmadsen/intent-record
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/beatmadsen/intent-record
+  changelog_uri: https://github.com/beatmadsen/intent-record/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/beatmadsen/intent-record/issues
+  documentation_uri: https://github.com/beatmadsen/intent-record#readme
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.9
+specification_version: 4
+summary: Local records storage for the expressed intent behind individual code changes.
+test_files: []